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SUBJECT = UPDATED PROCEDURES NOTEBOOK DOCUMENTATION 


The Build N update of the Integration Procedures Notebook 
is now available. Change pages may be obtained through the 
following command sequence’ 


ATTACHsCHGPAGE/UN=DEV1 
SESePRINT CHGPAGE 


Some parts of the document are now out of date (see 
Document Deficiencies below) but have not yet been removed. 
Howevers a compiete listing of the document can be obtained 
through the following command sequence? 


ATTACH s IPNDGC/UN=DEV1 
SESePRINT TPNODDC 


Some hightights of this revision are as follows: 


Catalog Management Policies: Section 2.3 has been updated 
to reflect how the Integration catalogs are managed for 
parallel tuilds. 

New Procedures: Sections 264259 205429 and all of Section 
2ell have been updated to describe the new procedures NVEBLD» 
NVEREP» GET» SAVEs and NVEMAP,. 


Updated. ._ Appendices: Appendix G now contains CYBIL 
instaliation information for version 81188. Appendix E 
contains the Build N Helpful Hints document. 


Document. Deficiencies: Appendices Cs» D and E are outdated 
and should not be used. Information formerly in Appendix H is 
now in Appendix E— and Appendix H should no tonger be 
referencede This document wilt be completely revised for 
Build Ce Your comments for that revision will be 
aporeciated. 
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INSTRUCTIONS TO_ CONTRIBUTORS 


* Subject and verb always has to agrees. 


* Being bad grammars the writer will not use dangling 
participles. 


* Parallel construction with coordinate conjunctions is not 
onty an aid to clarity but also is the mark of a good writer. 


* Do not use a foreign term when there is an adequate 
English guid. pro_gquoe_ 


* If you must use a foreign terms it is de_regor to use it 
correctly. 


* It behooves the writer to avoid archaic expressions. 


* Do not use hyperbole; not one writer in a million can use 
it effectively. 


* Avoid cliches like the plague. 


* Mixed metaphors are a pain in the neck and ought to be 
thrown out the window. 


* In scholary writings don*t use contractions. 


* A truly good writer is always especialiy careful to 
practically eliminate the too-frequent use of adverbs. 


* Use a comma before nonrestrictive clauses which are a 
common source of difficulty. 


* Placing a comma between subject and predicates is not 
correct. 


* Parentheticai words however should be enclosed in 
commase 


* Consult the dictionary frequently to avoid mispelling. 


-- Reprinted from the Texas._Newstetter. for. Medical 
Technology (Volume 5» Number 9» 1978) 
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1.0 NOS/VE SYSTEM OVERVIEW 
1.0 NOSZVE_SYSTEM_DVERVIEN 
1.1 INTRODUCTION 
The basic components of NOS/VE Include the follflowina: 
- A Hardware Initialization Verification Sequencer 


{HIVS) component 

~ Modifications to standard A170 NOS system components 

- A17G NOS application programs (land procedure files) 
which execute in the A170 NOS (Real State) 
environment» and provide system to system 
communication facilities. 

- The Virtual Environment code which is responsible for 
the execution of tasks in Native Mode in the Virtual 
State of the hardware. 


The nomenciature used to describe NOS/VE components is 
rather confusing. Frequentiys the Virtual system software is 
what is referred to as "NOS/VE*". When A170 NOS and the 
supporting utilities are presents the term “"“Duai State" is 
used. To differentiate the two execution modes of the machine 
the terms “Native Mode™s "Virtual Mode™s and "Virtual State” 
are used to describe the execution of C180 instructions. The 
terms “Reat State" and "NOS" are used to refer to the 
execution of C17C instructions. 

The model which is often used to describe the execution of 
NOS/VE in Dual State mode is that of one machine front-ending 
anothers and communication between the two machines occurring 
over a communications tinke From the software's point of 
views, another perspective is used. To the Virtual State 
softwares the NOS system is merely a job which happens to be 
executing in the Virtual State envelope created by EI. (The 
microcode translation of the C170 Instruction set is 
"“invisible™ to both the NGS and NOS/VE software.) NOS*'s view 
of the Virtual State is merely that of a job which runs at a 
control points and is communicated with through the 
K~display» The remainder of this section is meant to describe 
NOS/VE with regard to its components. 
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1.1.1 THE HIVS COMPONENT 


Included in the diagnostic worlds which establishes the 
initial Virtual Execution environments is the microcode for 
the CPU as well as a Native Mode monitor-like program caited 
the Error Interface (EI). The microcode is strictly supported 
by the diagnostic organizationss and neither the NOS nor the 
NOS/VE software will execute without microcode present in the 
CPU. The EI program is supported by Advanced Systems 
Nevelopment. There are currentiy two versions of EI» one 
which only supports A170 NDS and does tasks such as CMU 
instruction emulations and one which also supports the 
switching between the NOS and NOS/VE CPU monitors. This 
fatter version of EI requires a partner intermediary calied 
"ETE" which is statically toaded with the Virtual State 
softwares andis toaded during deadstart of NOS/VE. In order 
to assure that the right version of EI is presents the HIVS 
tape which is distributed by Advanced Systems Integration for 
use with NOS/VE is the correct version to iInstail. The 
version of microcode present on this HIVS tape will hopefully 
be the right versions but we have not discovered the necessary 
utilities te replace versions of microcode on a HIVS tape from 
an installed configuration such as that in which we test 
systemse 


1.1.2 A170 NOS MODIFICATIONS 


The wodifications required to support a Dual State 
execution environment are orimarily assembfed in the BLD170 
procedure file. Few specifics will be given here other than 
to state that half a dozen Peripheral Processor routines are 
invoiveds as well as modification to NOS CPU Monitor. The key 
aspect to note about these components is that a special 
version of A170 NOS deadstart tape must be used. <Agains this 
deadstart tape version is supplied by the Advanced Systems 
Integration project. There are additional procedure files 
which must also be present on this special deadstart tapes 
which are not documented here at this time. 


1.1.3 A170 NOS APPLICATIONS 


A portion of the software afltuded to as A170 NOS 
modifications could be classified as A170 NOS Apptications. 
The applications referred tos howevers are not present on the 
deadstart tapes but exist as permanent files which are invoked 
or processed by procedure files present on the deadstart 
tape. In the strict sense of the words those utifities which 
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are not execution order dependent or require system residence 
are placed on the deadstart tape. Utilities which must be run 
in a given sequence (and possibly as system origin) are 
governed by procedure files which are present on the deadstart 
tape. 


121.24 THE VIRTUAL STATE COMPONENT 


The Virtuat State software consists of both a statically 
and dynamicatiy tinked component. The statically tinked 
component is composed of Monitor and Task Services modules 
while most other tasks are dynamically tinked. In order to 
statically tink Monitor and Task Servicess the SES utilities 
VELINK and VEGEN or their Virtual State eauivalents must be 
use@de In other systems this statically linked system 
component is commonly referred to as the *unconfigured 
deadstart tape" or "bootstrap system". Qnce the "bootstrap 
system" has been generated which has its own LINKER/LOADER 
equivalents then it is possible to deadstart this bootstrap 
system and begin dynamic fink/loads. One of the attributes of 
this staticatty linked component is that there Is more than 
one partition associated with it. In order to keep these 
partitions separate during the CI build processs these 
partitions are placed on separate files. The content of these 
partitions is described in a subsequent section of this 
document. 

The dynamically Jlinked component of the Virtual State 
software consists of II format object text which is processed 
by the NOS/VE LOADER. In order to create [I format object 
texts it is necessary to either use the utility "CITOII" to 
convert CI object text to II object texts or else use a II 
compiler or assembler. In order to make this CITOII utitity 
availabie to each task created by the Virtual State softwares 
the object text for this utility must be statically linked and 
foaded with Monitor and Task Services. Once this utility is 
made available to dynamically generated tasks» it is necessary 
to retrieve the other utilities which establish communications 
with their A170 NOS counterparts. This is accomplished by 
executing a post-deadstart SCL procedure file which initiates 
the Remote Host and Interactive Facilities from the tibrary 
"OSLIB™ (which in turn was created From the CI object text 
file "XLJOSL"). 

The components mentioned thus far have been the statically 
Jinked modules for Monitors Task Servicess the CITOII utilitys 
and the dynamicatly finked modules from OQSLIB. There are 
libraries other than OSLIBs some of which are necessary for 
the successful execution of user tasks. Such a library is 
SYSLIB which contains the Object Code Utility modules which 
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provide for the creation of II object text tibraries. The 
SYSLIB tlibrary must be made part of a job's object library 
list if any II object ftibrary manipulations are to be made. 
From the compiler perspectives the run-time libraries CYBILIBs 
MATHLIBs FRTL» etc. must be created by a job which has SYSLIB 
as part of its object library tist. The compiler generated 
object text for a compiter such as CYBIL names the appropriate 
run-time fibrary in the object text records (eg. CYBILIB). 
Thuss a CYBIL program must access the appropriate run-time 
library (CYBILIB) and make this tibrary part of the job's 
object library list. This explicit manipulation of a job's 
object tibrary tist will eventually be replaced by job 
prologues which are created during accounting and validation 
and/or user protogues which establish a job's execution 
environment. 


1.2 VIRTUAL STATE PARTITIONING 


The system can be thought of as being divided into three 
partitions which consist of six object text files. Each 
partition has associated with it certain protections privilege 
and responsibility. The first partition consists of those 
routines that run in monitor mode and is known as the 
monitor. The second partition consists of those routines that 
run in job mode and is known as task services. The modules on 
file XLMMTR make up the monitors and the modules on files 
XLJI1F,» XLJ12F, XLJI13F and XLJIFF make up task services. The 
modules on file XLJBBB consist of user tasks which can be 
thought of as betonging to a third type of partition. This 
fatter partition contains routines which run in job mode in 
the user ring (for the purpose of converting CI compiler 
generated output into II format after it has been transferred 
from the A170 NOS software to the NOS/VE execution 
environment). In the memory maps which is described in a 
subsequent sections the code for this user partition resides 
in the "User Task{s) Library” and is made a part of each task 
created for NOS/VE. The system restructure which occurred 
with Build M made this partition retatively smaftl (since this 
partition must be toaded into memory at deadstart time). 
Aithough the build procedures altow for this partition to be 
replaced with one which contains additional user tasks» the 
preferred method of executing user tasks is to GET them from a 
NGS permanent file (after they have been generated by a CI 
compiler) to the NQS/VE execution environment and EXECUTE 
these tasks using the NOS/VE LOADER, If the execution 
environment is the simulator instead of the hardwares then new 
user tasks should be statically toaded in place of XLJBBB 
using the NVELINK procedure, 
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Any XDCLid symbol! within a given partition can be XREFf'd by 
any module within the same partition. To allow other 
partitions to XREF these same symbots,s the symbols must be 
gated. Gating a symbol only nakes the symbol available to 
other partitions during the Ttlinking process» it does not 
necessarily mean that the XDCL'd tocation can actually be 
referenced - that is controlled by the ring brackets. In 
generals only selected XDCL'd symbols are gated. A variable 
or entry point may be gated in the source specification using 
CYBIL and CPU ASSEMBLER tlanguage constructss or the object 
text may be modified by using the SES Object Code Utilities. 
Refer te the MAP<offset>K files produced by the NVELINK 
procedures for a list of the entry points avaiftabie to a user 
taske This tist of entry points preceeds the linkage of file 
XLJBBB and is entitled "INBOARD SYMBOL TABLE ENTRY POINTS FROM 
FILE : STSXOST™. It should also be noted that a similar tist 
exists For the Monitor entry points available to Task Services 
and is entitled similarly with the substitution of MTRXOST for 
STSXCST in the above title. 

Qccasions arise in which procedures are of common utility 
to more than one partitions but should not be gated across 
partitions. In such instancesy these procedures are placed 
upon 2a “"run-time™ library such as CYBILIBs and references to 
these procedures are satisfied at "LOAD" time from the 
appropriate library. "LOAD" time satisfying of externals can 
either be done staticaliy or dynamically. <A static load is 
accompfished through the SES Linker and Loader utilities. 
Dynamic toads occur through the use of the NOS/VE loader 
during the execution of a C180 jobe Whenever possibles 
dynamic toading of routines is preferred {as in the case of a 
compifer satisfying externals from a run-time library) since 
this is the mechanism which customers of NOS/VE systems will 
be usinge 


1.3 MANIPULATION _OF_NOS/VE_ PARTITIONS _AND_ LIBRARIES 


When bullding a systems monitor must be finked first. All 
gated symbots within monitor then become available to task 
servicess which is tinked second. Although some monitor 
symbols can be referenced by task servicess the only way to 
execute monitor code is via the exchange jump —- i.@.s the 
CALL/RETURN mechanism is not valid for use between monitor and 
job modes. User tasks are linked fast and can reference gated 
symbols defined in task services. It is important to note 
that although the linker will allow a reference to a given 
symbols the ability to actually preference the tocation iis 
determined by the ring brackets on both ends of the 
reference. 


oe ee 
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1.4 DATA_RESIDENCY/LIEETIME BASED_ON. PARTITION 


The following rufes apply to static data defined by modules 
in monitor or task services: 


1) Oniy modules within monitor may declare static data that is 
mainframe wired. 


2) Onty modules within ring 1 task services may declare static 
data that is mainframe paged. 


3) Oniy modules within ring 2 task services may declare static 
data that is in the Jfjob fixed segment. No modules may 
declare data in job pagable until the new system generator 
jis availablie, 


4) Oniy modules within ring 3 task services may declare static 
data that is in the task private segment. 


5) Rules 1 through 5 aiso mean that all static data for a 
module in a given partition will reside as specified. 


6) Static data for modules that run in the ring of the caller 
(XLJ1FF) must be read only when executing above ring 3. 


1.5 DUAL_STATE MEMORY MAP 


When dealing with a virtual memory system it is often 
Necessary to understand the real memory aspects of the 
softwere which is present in the machine. The following map 
describes the real memory aspects of the softwares and where 
it is mapped during the deadstart processe To make this map 
complete would require overlaying it with segment and page 
boundaries. Rather than attempt to produce this overlaying 
effects suffice it to say that (by convention) the boundaries 
described in this map occur at even page boundaries. Whether 
or not the pages which constitute any given area in the map 
are paged is a function of the attributes of the segment to 
which the srea belongs. 

The real utility of this map is in showing the relationship 
of values which are supplied to the SES Virtual Environment 
Generator through the skeleton VELDCM File. This skeleton is 
dynamically edited when the NVELINK procedure is invoked to 
produce the LDR<offset>oK file. The VELDCM variables are 
underlined in the relationships described after the map. By 
using the relationships givens it is possible to compute the 
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relative starting locations of different areas within a NOS/VE 
cump.e 

It should be noted that the reftationships given here are 
expressed in decimal byte addresses» while the machine 
addresses are hexadecimal. To pursue hexadecimal addresses 
requires a copy of the MAP<offset>K file. Specificaliys the 
load addresses for Monitors Task Services,» etc. are contained 
in the Virtual Environment Generator output which immediately 
Follows the LINKER output. 
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SS ee ie a i eh ee mem eres ite Sp +<-- Machine Address 0 (zero) 
3 a 

a 3 

+; A170 NOS Gperating H 

; System : 
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; H 
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/ / 

H : 

tee ee ee oe ee oe me a a ae w~=-=—+<€-- Maximum NOS Memory Address 
: NOS Page Tables El» : 
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1.5 DUAL STATE 


PERE PORE PI PE Re Fe HE 


M 
Re ad 


Page Size = 

= 
Page Table Size = 
Page Table Length «= 
ET Length = 

2 
Load Offset = 


Virtual Load Address 


Page Table Address 


EMORY MAP 


Cli 2% 43 8: 163 323 64 ] * 1024 
PAGESIZEYV 
{C 43 8: 16% 32: 643 128: 256; 512% 1024 J] * 1024 


MAXIMUM(<Page Size>»s<Page Table Size>) 
PILY 


8 * 1024 
8192 
EILENGTRY 
{[ 256; 1283: 643 0] * 1024 * 8 
{[ 2648; 10243 5123 0] * 1024 
LOADDEESETY 
Maximum NOS Memory Address = LOADQEESETY ~- EILENGTH 
= NOSLENGTHYV 
= LOADOFESETY + PILY 
= LOADADRY 
= LOADDEFSETY (By convention) 
= PTAY 
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200 OVERVIEW OF INTEGRATICN PROCESS 


The Integration process begins with the transmittai of a 
software products the command language procedures required to 
build the producty, installation procedure documentations and 
baseline documentation from the software development 
organization. Subsequent to this transmittalis, the Integration 
project is responsible for maintaining the program librarys 
standardizing the installation proceduress maintaining the 
installation procedure documentations and preparing the 
software release package for the Software Manufacturing and 
Distribution organization. In the interim time between the 
initial transmittal and the release of a software products the 
Integration project schedules periodic builds. The outputs 
from these builds are delivered to software development and 
test organizations and/or made part of the software release 
package. 


2e1 RELATED DOCUMENTS 


Qocument Title Distributor 

NCS/VE Procedures and Conventions SeW.e. Fewer 

NOS/VE Command Interface ERS DCS - ARH3609 
NOS/VE Program Interface ERS DCS — ARH3610 
SES User's Handbook DCS - ARH1833 
CYBER 18C System Interface Standard DCS ~- $2196 

Simulated NOS/VE Program Interfaces ERS DCS — ARH3125 
VEGEN ERS DCS = ARH2591 
VELINK ERS DCS -— ARH2816 
CYBIL Language Specification DCS = ARH2298 
CYBER 18C CPU CI Assembler ERS DCS = ARH1693 
CYBER 180 Simulator ERS DCS — ARH1729 
SES Procedure Writers Guide DCS — ARH2894% 
CYBER 18C Object Code Utilities ERS DCS — ARH2922 


Source Code Utility ERS DCS = ARH3883 
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2.2 STANDARDS 


In order to facilitate the Instaliation oprocesss certain 
standards will have to be set and adhered to by all members of 
the Operating System and Product Set. These standards witli 
cover the following items: 


a) All program tibrartes will have the same formats this 
wili be defined by (T8B). 


b) All output tapes will conform to some predetermined 
format in terms of numbers of files and what each file 
will containe This will be defined by (TBD). 


c) The above formats are intended to facilitate 
establishment of proceduralized installation decks. 
This implies that some convenient naming conventions 
must be observed. These conventions will be defined 
by (TBD). 


2+3 CATALOG MANACEMENT. POLICIES 


The Integration project builds two systems in parallel and 
manages two catalogs for each system. The primary system is 
the system that is between the beginning of the build cycle 
and the feature code cutoffs The secondary system is between 
the feature code cutoff and the end of the build cycle. 
Primary system files begin in the INT1 catalog and move to the 
INT2 catalog after the system has passed Confidence Testing. 
After aeesystem has reached its feature code cutoffs a 
stabitized feature buiitd is moved to the DEV1 catalogs the 
build from INT2 is moved to DEV2s and this system is now 
considered the secondary systems. Aiso at this times a new 
primary system is started in the INT1 catatog by adding its 
planned feature code to the previous primary system. When a 
build has completed its integration cycles the final build for 
that cycle ts moved to the REL1 catalogs It is at this time 
that a build is considered a candidate for transmittal to 
ether facilities for further development works a final Build 
Content Report is distributed and whatever usage documentation 
that is available is distributed. 
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The following diagram illustrates the function of each H 

Sade 

prem ee—e eee ee $e ann $ 2 ee fp ee a ee ee a ee + 
: ; Primary System H Secondary eee H eee System! 
__——— $e oo ee $ a we ee ee ee $e a ee ee ee = + 
: eine Catalog 3; INTL +; DEVI ; oe H 
a eh ee en fe er oe ee ee ew net 
: Latest Stable + INT2 + DEV2 + RELI H 
; Build Catatog H : H H 


In generals oprocedures executing from a egiven catalog 
access onty those files which have the same tevel of 
verification associated with theme The INT1 and INT2 catalogs 
will access the most recent compiferss SES tooltss etce while 
the DEVI and ODEV2 catalogs access a previous» more stable 
feyel of utilities. 

The REL1 catalog represents the "frozen" catalog for which 
changes are no longer being accepted (typically a snapshot of 
the fast build cycle). This is generally the system thet is 
being run in SVL closed shop and is retained for duplicating 
problems found there, The RELI cataiog witli change no more 
frequentiy than once for each build cycle. The INT2 and ODEV2 
catalogs contain the tatest stable builds (iee. the builds 
have passed Confidence Testing) for the primary and secondary 
systems» respectively. The INT1 and DEV1 catalogss however, 
are "working catalogs™ for the debug of new system fixesy new 
proceduress etce The stability of these catalogs cannot be 
predicted. 
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204 BUILD PROCEOURE DESCRIPTIONS 


In order to understand the procedure descriptions which 
follows, something should be said as to the sequence in which 
these procedures are used to generate systems. The following 
is an attempt to accomplish this: 


224-21 INTRODUCTION 


The command ftanguage procedures corresponding to NOS/VE 
builds ali reside in the INTl»s INT2s or DEVI catalogs 
depending upon the desired level of verification the system. 
has attainede It is assumed that the DEV1 tlevel of 
verification is the minimum level of system verification 
required by most usersy therefore the DEV1 catalog is 
frequently referenced in the remainder of this section. To 


ae 
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obtain a listing of the complete set of command tanguage 
procedures provided in the Integration catalogs execute the 
Following command language sequence? 


SES*LISTMEM B=PROCLIB UNe<Integration_Catalog> 


Before running the build procedures as batch jobs» a check 
must be made to insure that the user number under which the 
job will run has sufficient validation limits for the job to 
execute. The minimum values for certain timits must be as 
follows: 


24378 

unlimited 

unlimited 

4096 

2008 (if simutator is to use LCM) 

unlimited (each ltibrary is built via batch job) 


o 
Ma) 
ion Ho won ou 


The current values may be obtained with the LIMITS control 
Statement. If they are not ftarge enoughs have the operations 
staff change them, 


2e4e2 INVOKING THE PROCEDURES 


The procedures described below are documented as 
"SES. <Procedure_Name>", In actualitys to invoke the 
procedures in this manner assumes that there is a file named 
*PROFILE*® in the current catalog which names the Integration 
catalog to search for the procedure {via the *SEARCH? 
directive). The alternative mechanism for invoking these 
procedures is to code the procedure call asi 
"SESs<Integration_C atalog>.<Procedure_Name>*",. Many of = the 
procedures use the #PRCUNAM!' vatue for substitutable user 
names» meaning that the catalog in which the procedure is 
found is the catalog which is searched for filese This is as 
it should bes since each of the Integration catalogs contains 
a different version of the system. 


All of the procedures described in this document have 
SHEL? ® documentation associated with theme Use the 
SESs<Integration_Catalog>s»sHELP.<Procedure_Name> caf! to have 
procedure documentation printed at your terminal, 

Practically all of the procedures described in this 
document are written to execute in "BATCH" as well as tocal 
mode. In order to provide a consistent result when these 
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procedures are runs it is necessary to save many of the 
generated files as permanent files. White some purists see 
this as “catalog polution™,s we make all attempts to preserve 
only those files which are necessary for future reference or 
usage» Whenever possible tocal file names generated by the 
procedure are given unique names so as not to conflict with 
any user files.» In numerous instancess convenient "reserved*® 
file names are used to enhance the configurability of these 
procedures. For examples ail files accessed by the procedures 
are searched for first as local filess then as permanent files 
in the catalog in which the procedure is executings then 
(optionaily) in the catalog specified by the *AREA*® parameter 
vajues and finally in the catalog in which the procedure was 
found. Thuss if the name of a tool accessed by the procedures 
is knowns several versions of this tool can be tried through 
iterative executions of the procedures without requiring 
procedure modification. To aid in the isolation of tools 
accessed by the procedures a "common deck" type structure is 
included in the procedure tibraries which names many of the 
toois to be accessed by the procedures. These structures 
exist as records on the procedure ftibrary which are INCLUDEd 
into the relevant procedure file. Initially we have 
partitioned these tools into the records #TOGLALL',» 'TOGL170%s 
and *TOGLI80'. Experience has shown this partititioning to be 
somewhat combersome for some of the proceduress and will 
probably be fine-tuned in subsequent revisions of the 
procedure fibrary. 

Some of the procedures contained on the procedure libraries 
change very frequently due to changes in system structure or 
for other reasons. It is inevitable that errors creep into 
the procedures at times. Often it is quicker to change the 
KCL generated as a result of invoking the SES procedure than 
to change the procedure ltibrary.e The SES processor may be 
invoked via the SESsTEST.<Procedure _Name> mechanism and the 
resultant KCL is written to aé file named SESTEST. This 
SESTEST file may then be editeds and the offending control 
statement corrected. A subsequent CALL»sSESTEST statement may 
then he used to execute the corrected KCL. while we do not 
necessarily condone this approach to fixing procedure files we 
can hardly deny its existence. If» for exampies it should 
prove necessary to provide our customers with instalidation 
procedures for software which we generate with SES procedures, 
it would be our intent to ship the SES generated KCL 
statements rather than the SES procedure and a copy of the SES 
processofe 
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22423 CURRENT PACKAGING OF NOS/VE SOURCE 


There are two execution modes of NOS/VE which are referred 
to as the “standalone™ mode and the "dual-state”™ mode. All of 
the NOS/VE source modules which execute in the CY180 Virtual 
State are contained on a program tibrary named 'NOSVEPL*. The 
program interfaces to the Virtual State systems those 
described in the NOS/VE Program Interface ERSs exist as common 
decks on aoeprogram library named *#QSLPI*'*. The content of 
these two program libraries is referred to as the standalone 
system. A deadstart tape can be produced of the standalone 
system for execution on the hardwares or the output of the 
Virtual Environment generator can be executed directly on the 
Hardware System Simulator. The I/0 support of this standalone 
system when running on the simulator is defined in a separate 
set of common decks on a program tibrary named '#CYBICMNY. 
Refer to the Simutated I/G ERS for documentation of these 1/0 
interfaces. 

The dual-state execution of NOS/VEs in conjunction with the 
NOS operating systems requires NOS system modifications and 
the presence of a set of NOS utilities and procedure files. 
The software which supports this dusi-state environment from 
the  'NQS! side of the hardware is contained on a program 
fibrary named tVE17CPL*. Inctuded in this package of NQS/VE 
support programs is a software application called the Remote 
Host Facility which supplies job-to-job communication between 
the Virtual State and NOS portions of the CY180 machine. 


22424 UPDATE THE SOURCE LIBRARIES 


The Integration project typicaliy updates the base source 
libraries prior to starting any recompilation or assembly of 
the system. In order for a user of these procedures to modify 
the source of a system routine he/she can use the SES 
'GETMODS! procedure to extract the source being modifieds or 
create the source in some other manner. If GETMODS was used 
to extract the sources then REPMODS can be used to put this 
changed source on a MADIFY program tibrary in the user's 
catalog. Then the filename containing this program tJlibrary 
must be specified as the value of the 'AB® parameter of the 
NVEBILD proceduree (Refer to the Source Maintenance Section 
of the SES Userts Handbook if you have questions about source 
maintenance.) 
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20405 COMPILE/ASSEMBLE FROM SOURCE 


The efficiency of the Integration build procedures is a 
Function of how much of the system is being built and how much 
information is supplied to the procedures when they are 
invoked. If the name of each module to be recomepifed and its 
object file residency is known prior to invoking the 
proceduress then the most efficient method is to use the 
NVEBILD procedure and specify the lists of module names and 
library names via the 'M* and *'L! parameters. If only the 
module names are knowns then the NVEBILD procedure with the 
'™! parameter specified should be used (a search for the 
library names will be used). If onty a modset File is 
availatbles the scope of changes is not readily apparent ({iee. 
several common decks are changed) or the number of modules to 
be recompiled is prohibitively targe for manual specification 
to the NVEBILD procedures then the NVEBLD procedure can to 
used to automatically generate the correct NVEBILD procedure 
calls (using a NOSVEPL cross reference). If it has been 
determined ahead of time that several modules on the same 
fibrary are being changeds then it is more efficient to 
rebuild the entire tibrary using the ‘'fL* parameter of the 
NVEBILD procedure. If several libraries need to be rebuilt 
{as in a full system build)» then the NVEBILF procedure shoutd 
be used. 

The general philcsopy behind the NVEBILD procedure is to 
extract the latest source of a module from a program librarys 
compile or assemble the source to produce the appropriate 
object texts, ireplace/add the updated object text to the 
appropriate system ltibrarys, and save this library in the 
catalog in which the procedure is executed. The final result 
of the execution of the NVEBILD procedure should be an updated 
system library in the current user's catalog which is ready 
for the "LINKER'® phase of the build. Jobs which run in “user 
mode",s that is the interface to the system is only through use 
of the program interfaces (QSLPI)» are saved merely as object 
text files in the user's catalog and LINKER-LOADER directive 
modifications are required to include these files as part of 
the system. This latter capability witt gradually be replaced 
by the Virtual State LOADER and Library Generator features as 
they become available. 
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204.6 BEGIN THE LINKER-LOADER PHASE 


The LINKER (SES.VELINK) and LOADER (SES.VEGEN) are packaged 
together in the Integration procedure NVELINK. This is for 
convenience purposess in that most LINKER changes to the 
system require a corresponding LOADER directive changes and 
the intermediate results from the LINKER execution are not the 
primary output used for system checkout. Prior to starting 
the LINKER=-LODADER phase of system builds» some decisions need 
to be made as to the target execution environment for § the 
resultant output. 

If the target execution environment is standatone NOS/VE»s 
then the default NVELINK options should be used to produce the 
File named 'LGBOK'. This file can be run on the simulater 
using the NVESIM procedures or can be used to create a 
deadstart tape using the 'VSN* parameter of the NVESYS 
procedures 

If the target execution environment is a duai~state 
environments then the OFFSET parameter must be used to specify 
how large the NOS system will bes The systems produced “(for 
the Arden Hilis $2 use OFFSET=256 to produce a LGB256K file. 
The LGB256K file is used by the NVESYS procedure (when 
QFFSET=256 is specified) to produce @ deadstart tape image on 
disk named 'TP256K!. This deadstart tape image must then 
replace the file named TPXXXK»s which the dual-state deadstart 
procedure UPMYVE will then find. Refer to Appendix E for 
Dual-State and standalone deadstart procedures. 


2e4e7 GENERATE THE DEADSTART FILE 


In order to generate a deadstart tape for standalone 
NOS/VE> it is only necessary to run the NVESYS procedure and 
specify the VSN of the tape to he written, Prior to 
generating a duatl-state deadstart files thowevers it is 
necessary to verify that the utilities necessary to support 
the dual-state deadstart have been rebuilt via the DSBILD and 
BLDEI procedures» There are two portions of the dual~-state 
EI» the A170 oortion is built using the BLDEI procedures and 
the C180 portion is rebuild using the NVEBILD procedure (deck 
named MLAETI). 
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265 NVEBILO PROCEDURE DESCRIPTION 


The procedure NVEBILD ts used to add or replace modules on 
@ base object text file. NVEBILD retrieves the source module 
from a program tibrarys using the following search order: 


1) an alternate base optionally specified by the 
user (looking first in the current catalogs and 
then in the <Integration> catalog) 

2) GSLPI (from the <Integration> catalog) 

3) NOSVEPL (from the <Integration> catalog) 


This module is then compited or assembled» and the 
resulting object text is either added to or replaced on a base 
file. A new version of the base file will be created in the 
current catalogs along with the direct access file NOSLIST 
which contains the compilation or assembly tisting(s) of the 
module(s) compiled or assembled (one tisting per records 
headed by the matching MADIFY module names listed via the 
LISTNVE procedure described in this document). If there are 
any compilation errorss the error listing(s) will be put on 
the direct access file ERRDRS (which has the same format eas 
NOSLIST) in the current catalog. The direct access file 
ERRLIST will contain a one line error message which indicates 
the type of error detected for all errors diagnosed by the 
proceduress By listing the ERRLIST file from a terminals a 
Summary of the number and types of errors encountered can be 


determined. There are conditions such as unrecoverable disk 
errors which can cause erroneous messages to occur in this 
File. In such case it is necessary to examine the DAYFILE 


produced by the procedure to isolate the problem. 


If a specified module is to be replaced (i.e. it is 
already part of the existing system)» NVEBILD will by defauit 
use the same compitation options and will reptace it on the 
same base object text file as when it was first added to the 
system. These options may be overridden by specifying the 
corresponding parameters described below. 


If a specified module is new to the systems the compilation 
and base object text file options may be directiy specified 
using the parameters described below. If a list of new 
modules is specifieds the compilation and base file options 
must also be specified as tists» and NVEBILD will match 
everything up positionally. If these parameters are not 
specifieds, and NVEBILD is executing in LOCAL modes a warning 
message will be issued telling the user that the module is not 
in the current system. The user will then be prompted for the 
necessary information. If these parameters are not specified 
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and NVEBILD is executing in BATCH modes the compilation and 
base file options default as specified below. 


If the ‘41% parameter is specified » each module*s object 
text will be copied to a temporary tz! file. The old tibrary 
file will then be purgeds and the '2z! file will be renamed as 
the new tibrary file. Ait compilation tlistings will be 
LIBEDIT*ec onto NOSLIST from 2 temporary tisting file at the 
end of the procedure. 


When an entire library is being rebuilt via the #4]! 
parameters the module names and their corresponding 
compilation options are obtained from a file which contains 
ali this information for each library. NVEBILD searches for 
this file first in the current catalogs» and then in the 
<Inteoration> catalog. The name of this file must be the name 
of the fibrary minus its first character (e.ge  'LJI3F* for 
the library "XLJ13F")» and the first line of this file must be 
the file name. To make additional entries or change existing 
entries in this files the following procedure should be 
followed: 


1) EXTRACTs<libdeks>/UN=<Integration>d. 
(where <libdeks> is the name of the compilation 
information file for the library as described above,» and 
<Integration> is the Integration catalog) 
2) Edit <libdeks> to add or change entries. The format and 
spacing of each entry is important and must be as follows? 
(<m>a<cre<xrefrs<ll>s<i2>) 
where 
™ = a f~character left-justified module name 
c = a l-character compilation option (#O'%5!1%, or #343 
see description of *ct parameter below) 
xref = a 3-character left-justified cross reference 
option (either "YES*® or *#NO #) 
1 =» a 7Vecheracter teft-justified destination library 
name . 
12 = a Y=character teft-justified secondary library 
destination name. 
the entries currentty in these files ali follow this 
format so that any additional entries may be tined up 
quite easily with them. 
3) SAVE»s<libdeks>. 


NVEBILD (with the '4* parameter specified) may then be used to 
rebulld the Jlibrary using these new/modified compilation 
options. 
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The format of the NVEBILD is as follows: 
SES.NVEBILE € m=(<module named..<module name>) Jj 

{C t=< library name > ] 

C c=(<compilation optiond>ee<compilation option>) ] 
{ area = < user name > ] 

{C xref=(< xref option>e.<xref option>d) ] 

{ sb = <alternate base> ] 

C omit = (<module name>ese<module name>) ] 

{C link 3: tink = <offset valued ] 

C test = <test fille named ] 

{C print J] 

{ batch ] 


m 3 The module names or range of moduless or tist of 
module namese 


1 3 The tlitbrary name(s) onto which a newly compiled 
module for modules) is fare) to be added or 
replaced. If the  *M*® parameter has not been 


~specifieds then the entire library is recompiled. 
To recompile several libraries at atime it is 
recommended that the NVEBILF procedure be used» 


c = 0 to assemble a module 

c = 1 to compile a CYBIL module (DEFAULT) 

c = 3 to compite a CYBIL module using CYBICMN type 
declarations 


area 3 Option to obtain the object files or linker 
perameter files from another user's catalog (other 
than the current catalog in which the procedure is 
executing). The default is for no area user 
catalog to be searched. 


jo 3 List options to be in force during CYBIL 
compilations. May be any combination of As Cs Fy» 
O59 Is Ws Rs or QO (zerode The defauit is 0 
(zero). 


ab 3 The user's aiternate base program fibrary 
containing new and modified modules. The default 
is "NEWDKPL!?. 


omit 3 Used when running 2a full builds a module name or 
list of module names to omit from the build. The 
default is none. 
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fink 3 Option to link the newly bullt or modified system 


using the procedure NVELINK. Specifying simply 
the keyword 'LINK® or FLINK = OF Finks a NOS/VE 
stand-alone systeme To link a dual state systems 
specify *LINK = <offset>! where <offset> may be 
given the values 256» 1285 or 64, The default is 
to not fink the system. | 


test : The name of the file containing the NOS/VE test 
commands to be input to the simulators which will 
be executed after the system has been tinked 
{using procedure NVESIM). This parameter is 
invalid if the "LINK! option has not atso been 
specified. The default is to not run the 
simulator test. 


print Detion to print the link map following the linking 
of the system. The default is not to print the 
link mape 


batch 3 Run NVEBILD in BATCH mode. The defautt is to run 
it locally. 


NOTE : One of 'm' or ti! parameters must be specified. 


2e5e1 NVEBILF PROCEDURE DESCRIPTION 


NVEBILF is an SES procedure file which submits one batch 
procedure execution of NVEBILD for each system fibrary,s, each 
with the "1! parameter specified for the tibrary to be built. 


The format of the NVEBILF is as follows: 


SES.NVEBILF € § = <fibrary name >] 
 £ batch ] 


' 3 The "1! parameter specifies the library to be 
built. It can be one ftibrary or a tist of 
libraries. The default is to rebuild the entire 
system. 


batch 3 Run NVEBILF in BATCH mode The defauit is to 
run it locally. 


Note : To rebuild one tibrarys the following are logically 
equivalent? 
1) SESeNVEBILF Jt=< library name > 
2) SES.NVEBILD t=< library name > batch 
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The expansion of either of the above procedures can be 
prohibitivety long when being run from aéeterminal. The 
thatch! keyword on the NVEBILD procedure is implemented for 
the express purpose of freeing up the terminal for other 
purposes (the procedure expansion is done within the BATCHed 
job). 


20562 NVEBLD PROCEDURE DESCRIPTION 


The NVEBLD procedure generates and routes to the input 
queue a set of NVEBILD Jobs which compite the modified or 
replaced decks and those decks which call modified or reptaced 
common decks. Firsts, NVEBLD finds the decks modified by 
creating a list of all the *DECK lines in the 'mf* files) and 
a list of all the decks in the 'dkFf* file(s). It combines the 
two lists» sorting and deleting duplicate names. The combined 
list is checked against the current tist of modules which make 
up NOS/VE» using the cross reference file from the ='xrf! 
parameter. Then the procedure again creates two tists: a fist 
of modules to be compiled and a list of common decks to be 
checked. A subset of the cross reference is used to generate 
a list of all decks referencing the given common decks. The 
list of modules and the list of decks referencing the modified 
common decks are combineds sorted and duplicates are removed» 
This final list is then used to generate the NVEBILD jobs to 
compife the necessary modutes. 

The format of the NVEBLD is as follows: 

SESeNVEBLD {€ mf = <file_nameD J 
{ dkf = <file name> J 
{C xrf = <file name> Jj 
{ nit = <tlibrary name> ] 
{[ area = <user name> ] 
{C ab = <file name> ] 
{ batch } local : defer : batchn ] 


mf 3 The file or fist of files which contains the 
modsets or a list of *DECK deck names. If the 
parameter is omitted the file MODFILE is used. 


dkf 3: The file or tist of files which contains the new 
or replacement decks in a group file formate If 
the parameter is omitted the file DECKFIL is 
usede 


xrf 3 The NOS file name for the file containing the 
eross reference of NOSVEPL. If the parameter is 
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omitted the file XNVEPL is used. 


ni: The ftist of library names to be omitted from the 
build. There is no default. 


area : The search order to find any file. If the 
parameter is omitted the user names of the current 
user and the user name of the procedure are used 
for the default user names. 


ab 3 The file name of the alternate base.e The default 
is NEWDKPL. 


batch + local i defer $$ batchn : The job run mode of the 
procedure@e If none are defined LOCAL is used. 


20503 LISTNVE PROCEDURE DESCRIPTION 


LISTNVE is an SES procedure file which extracts the 
compitaticn listings of the modules specified by the tM? 
parameter (module names correspond to the MADIFY deck name 
given the module) from a text Jibrary file and writes them to 
the file specified by the 'F3 parameter in a printable 
format. The 'M* parameter may select a singte modules a tist 
of modules» and/or a range of modules on the library file. 


The tlibrary file which contains the fistings may be 
selected via the ‘'I* parameters and defaults to NOSLIST. 
LISTNVE will search for this file in the current catalog 
firsts and if it is not there it will go to the catalog 
specified by the "UN! parameter. 


When LISTNVE has compteteds the output file selected by the 
'O! parameter will be a tocal file. It is got automatically 
printed unless either the '"*PRINT® or "BATCH option is 
selected. 


The format of the LISTNVE is as follows: 


SESLISTNVE [ m = ( ¢€medule name>e~e<module name> ) Jj 
{ i = <file named ] 
{Co = <print file name> ] 
{ un = <user name> ] 
{ print ] 
{[ batch ] 
m 3 The module name(s) and / or range of module 


names which are to be extracted for 


Sad 
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printing. The default is to extract and 
format gli of the modules. 


i; f i from 3 The name of the text tlibrary file from 
which the compilation tistings are to be 
extracted. The default is NOSLIST. 


o + to 3 upon 3 The name of the file which will receive the 
formatted listings to be printed. The 
default is LISTING. 


un 3 The name of the cataiog to search for the 
fibrary file should it not be found in the 
current catalog. The default is the 


<Integration> catalog. 


print 3 Cetion to print the listing file after it 
is formatted. The default is to not print 
the listing file. 


betch 3 Run LISTNVE in BATCH modee The default is 
to run it focally. 


206 NVELINK PROCEDURE DESCRIPTION 


NVELINK is an SES command tanguage procedure file which 
will call both the VE Linker and VE Generator (using the 
standard SES procedures VELINK and VEGEN) to produce a 
checkpoint file and tink map file. In order to do this it 
widi fink monitor and task service routines from their object 
text files. It wil! search all files that it requires 1) from 
local files 2) from the current catalogs 3) from area user's 
catalog (if the area parameter is specified)» 4) from the 
<Intecration> catalog. 


NVELINK will fink either a stand-alone or a dual state 
system. The choice is made via the OFFSET parameter (see 
description below). NVELINK will put the checkpoint file on 
the direct access file LGB<offset>Ks and the tink map will be 
placed on the direct access file MAP<offset>ks, where the value 
given the OFFSET parameter is substituted into each name for 
<offset>. 


To tink additional user jobs into the systems create a file 
in the current catalog containing the commands needed to 
obtain ail the necessary files as wel! as a call to VELINK for 
each user job to be tinked. Specify this file via the ADD 
parameters and NVELINK will pick it up and physically insert 
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it into procedure command stream immediately following the 


last cali to VELINK. Ihe first line_in this. file MUST be the 
file. namesi_ 


The format of the NVELINK is as follows: 


SES.sNVELINK (€ offset = < load offset > j 
{ ps = < page sized ] 
{ pti = < page table tength D> ] 
{[ save ] 
{ quick ] 
{ add = < additional links file > J 
{[ dump ] 
{ area = < user name > ] 
{ print J 
{[ test = < test file name > ] 
{ batch ] 
offset 3 The lead offsets, used to determine whether to 


fink a stand-alone or a dual state system, 
QFFSET = C links a stand-alone system (DEFAULT) 
OFFEST = 256 ftinks a dual state system (to use 
on the $2) 

GFFSET = 128 links a 128K dual state system 
OFFSET = 64 links a 64K dual state system 


ps 3 Page size of the target NOS/VE systems expressed 
in muittiples of 1024 bytes. Values may be ls 2» 
49 89 16s 329 or 64. Default is 8. 


pti 3: Page table fength of target NOS/VE systems 
expressed in multiples of 1024 bytes. Vatues 
may be 459 8s 16, 32,9 649 128,» 256s 512s #or 
1024. Default is 16-4 


save 3: GCpetion to save the monitor and task services 
segment files created during the Ilink for 
subsequent “auick link" use by this procedure. 
The default is not to save these segment files. 


quick ? Option te do a "quick link"™, A more complete 
description of this option can be found in the 
section entitied "Quick Link Option of NVELINK 


Procedure™, The default is not to do a quick 
link. 
add 3 . The name of the file containing the commands 


needec to tink additional user jobs into the 
system. The default is to not link in any 
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additional user jobs... 


dump 3 Option to print a memory dump of the system. 
Default is no memory dump. 


area 3: Qption to cbtain the object files or tinker 
parameter files from another user's catalog 
(other than the current catalog in which the 
procedure Is executing). The default is for no 
area user catalog to be searchede 


print 3 Qetior to print the link map» The default is 
not to print the Jink map. 


test : The name of the file containing the NOS/VE test 
commands to be input to the simulators which 
will be executed after the system has been 
linked (using procedure NVESIM). The default is 
to not run the simulator test. 


batch 3 Run NVELINK in BATCH mode. The default is to 
run it locally. 


2e6e1 LPF FILE DESCRIPTION 


The LINK commands used in the NVELINK procedure do not 
specify enough information to totally define the requirements 
of the tinking operation. Many additionai parameters are 
supplied to the linker through additional data files. This 
includes information such as: 


—~ Ring Numbers 
Segment Numbers 
Segment Attributes 
Execution Privilege 


Currently this information is supplied to the tinker via 
the SES Linker Parameter File (LPF) file. The linkage between 
the Linker and the LPF file is activated by the LPF=LIBLCB 
parameter on the LINK commands. For the monitor linkage this 
information is on LPF file MTRLCBs task services linkage 
information is on LPF file STSLCBs and EI/EIE tinkage 
information is on EILCB/ETELCB respectively. 
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2e6e2 VELDCM / LDR FILE DESCRIPTION 


The VELDCM file used by the procedure NVELINK contains 
directives tec the CPF Generator which allow it to produce a 
checkpoint file from the segment files produced by the VE 
Linker. These directives set up the physical environment into 
which NOS/VE is placeds and include such things as the 
definition of the page sizes job and monitor exchange package 
addresses», page table address and lengths prealiocated segment 
array definitionss etc. 


VELDCM is a "skeleton" file which is dynamically edited 
during the execution of the NVELINK procedures depending upon 
the specification of the OFFSET» PSs and PTL parameters. The 
edited file is then put on a direct access file named 
LOR<offset>K (where <offset> is replaced by the value given to 
OFFSET when the procedure was called) in the user's catalog. 
It contains the directives to the CPF Generator which set up 
the physical environment for that particular tink. This file 
must remain permanent in the user's catalog after NVELINK has 
been executeds as the procedure NVESYS uses this file in 
building 2 deadstart tape. 


207 ADDING USER TASKS _TO_NOSZVE 


2efe1 INTRODUCTION 


A user task can be defined as a group of modules tinked 
together that will execute in the ‘user ring* of NOSIVEs 
currently ring 11.2 This task may make calls to any gated 
entries within task services (rings 1 through 3) if the cali 
bracket will allow the call. Data defined within task 
services may not be referenced from rings 4-15. 


2e7e2 QUICK LINK OPTION GF NVELINK PROCEDURE 


To do a "quick link", specify the QUICK option on the call 
to NVELINK (see the section entitited "NVELINK Procedure 
Description ). In this case NVELINK does not link monitor and 
task services from their object text files each time. 
Insteads it uses already. linked monitor and task service 
environmentss and just jiinks the specified user object files. 


The QUICK option causes NVELINK to run faster and requires 
less resources than the full Jinks and therefore should be 
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used instead ef the full link when only _user_tasks are being 
added to NOS/VE. 


NVELINKs with the QUICK option specifieds should not 
require any modification to execute in different user task 
configurations. The user can merely add the user object text 
file produced by an assembly or compilation to the XLJBBB file 
using the SES.GOF procedure. To fink additional user object 
files into the systems specify the necessary command file via 
the ADD parameter. The contents of this files its uses and 
the function of the UJ and ADD parameters are described in 
greater detail in the section entitied "NVELINK Procedure 
Description". 


208 NOS/VE SIMULATION 


22821 RUNNING A SIMULATOR TEST (NVESIM PROCEDURE) 


NVESIM is an SES procedure file which will run either a 
batch mode or an interactive simulation of NOS/VE. This 
option is selected via the "TEST® parameter. If *TEST* is not 
specifieds then the simulation will be run interactively. If 
a batch mode simulation is desireds then 'TEST® is used to 
specify the name of the file containing the NOS/VE test 
commands that are to be input to the simulatore The 'BATCH# 
keyword must also then be specified. If the user wants to use 
his/her own simulator directives files the "CMDS" parameter 
must be specified. 


NVESIM also allows the selection of the checkpoint file to 
be used for the start of simulatione <A checkpoint file may 
aiso be optionally saved at the end of the test. The C180 
memory size may be changed via the *MEM! parameter. 


The NVESIM procedure will create several permanent files in 
the user's catalog if not run interactively. These are 
itemized as follows: 


1) JOUIPUT. This direct access file contains all of the 
output of the NVESIM procedures inctuding 
- acopy of the command file used as input to the 
simulator (C'TEST® parameter ) 
- the output produced by the system 
- the SESLOG file 
~ areformatted keypoint listing 
~ DEBUG output (Cif 'SIMDBG!' was specified on the 
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NVESIM call) 

- a summary of all (paging) disk I/0 (CHIGLOG file) 

-~ the toad map produced by the CITGII conversion = § and 
execution of XUUTL (SIMLOAD file) 

- f(optionaliy) a hex dump of the checkpoint file at 
the end of simulation 

- the job dayfile. 

This File Is automatically sent to the line printer. 


2) SESSMKE. This direct access file contains the keypoint 
data produced by the simulator. It is reformatted by 
the procedure NVEKEY before being written to the file 
TCUTPUT. 


3) JRAYE. The dayfile of the NVESIM job will be written 
to this direct access file shoutd it terminate 
abnormally. 


Additionallys if the "NCPFt parameter is specifileds, NVESIM 
will create 4 direct access files which together contain the 
NOS/VE environment at the end of simulation. The file 
specified by the  'NCPF*® parameter will contain the current 
NOS/VE checkpoint file. The other 3 files (formed by adding 
the characters Os 1» and 2 to the "*NCPF! File name ~ which 
must therefore be six or tess characters tong) are used “for 
NOS/VE memory pagings 

The format of the NVESIM is as follows: 

SES SNVESIM [€ test = < command file > ] 
{ cmds = < simulator directives file > J 
{ cpf = < checkpoint file > ] 
{[ nepf = < new checkpoint file > J] 
{ mem = < memory size in hex > Jj 
{ neds ] 
{ run = ¢€ instruction count > Jj 
{ simdbg ] 
{ dump Jj 
{ batch ] 


test 3 The file containing the NOS/VE test commands. 
The default is to run interactively. 


cmds 3 Simulator directives file which should be 
supplied by the user. The default is to use the 
one created by the NVESIM procedure. 


cpf : The checkpoint file used for the start of 
simulation. The default is "LGBOK®™, 
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nepf 3: The checkpoint file to be saved at the end of 
simulation. The default is not to save a 
checkpoint file. 


rem % The C180 machine memory sizes in hexs needed to 
run the simulation. The default is 
*100000(16)", 


Option to use the version of the checkpoint file 
from the <Integration> catalog which has already 
been deadstarted. The default is to use a 
checkpoint file which has not been deadstarted. 


nods 


run 3 A count of the number of suimulated instructions 
to execute. The default is 800000 instructions 
(or the profile variable value for *®RUNCNT?#), 


Qption to turn DEBUG on for the current 
simulator run. The default is to run with DEBUG 
off. 


nf 
3 
a. 
o 
tn 
oe 


dump 3: Qption to include the dump of the checkpoint 
file at the end of simulation as part of the 
NVESIM outpute The default is not to dump the 
checkpoint file. 


batch 3: Run NVESIM in batch mode. The default is to run 
it locally. 


2e8e2 NVEKEY PROCEDURE DESCRIPTION 


NVEKEY is an SES procedure file which creates a simulator 
generated keypoint trace file. The output of this procedure 
is tre local file 'KEYFILE?®. 


The format of the NVEKEY is as follows: 


SES.NVEKEY CE kpf = <€ keypoint file > J 
{ format = < SIM } HOW D> Jj 


kpf 3 The keypoint file generated by the simulator 
which is used as input to XXM7KEY. The default 
is *SESSMKF!®, 


format : Specifies whether simulator or hardware format 
keypoints are being processed. Default Is 
srme “ 
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208.3 DUMPING A SIMULATOR CHECKPOINT FILE (NVEDUMP PROCEDURE) 


NVEDUMP is an SES procedure file which makes a DSDI dump of 
a simulator checkpoint file. 


The format of the NVEDUMP is as follows: 


SESeNVEDUMP € cpf = < checkpoint file > ] 
C i = € output file > J 
C dump = STNO ¢ ALL J 
{C print ] 

{C batch J] 

cpf : The checkpoint file which is to be dumpede The 
defauit is "CKPT®. . 

13: The file which is to receive the dump output. 
This file will be a tocal file after the 
procecure has finished execution. It is pot 
automatically printed, The default is 
"DSOIDUT". 

dump 3: Option to either dump the environment according 
to ASID (BUMP2=STND) or dump the entire 
environment (DUMP=ALL),. If “"DUMP=STND*® is 
chosens then the DSDI directives are taken from 
the file DSDIXs which the procedure wil! search 
for first in the current catalog and then in the 
<Integration>d catalog. The default is 
"DUMP=STND", 

print 3 Option to print the DSDI dump output. The 
defauit is not to print the dump. 

batch 3 Run NVEDUMP in BATCH modee The default is to 


run it locally. 


2+9 BUILDING A_DEADSTARI_EILE 


2eGe1 INTRODUCTION 
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20902 CREATING THE FILE (NVESYS PROCEDURE) 


The SES procedure NVESYS builds a deadstart file from the 
checkpoint file created by the linking of the system. The 
IDFFSET! parameter allows the option of building either a 
Stand-alone or a dual state deadstart file. If the parameter 
‘YSN? is specifieds then the deadstart file will be written to 
tape; otherwise it is written to the File TP<offset>K where 
the value of the 'OFFSET* parameter is substituted for 
<offset> in the name of the file. 


NVESYS requires additional object files for incliusicon on 
the deadstart file.» These object files contain PP object code 
for the following functions: 


1) Deadstart (file XIDST) 

2) 844 driver (file XIDSK) 

3) Consote/Printer drivers (file XIDSP) - standalone 
only systems 

4) PP helper (file XIHLP) - standalone onfy systems 

5) PP Resident program (file XIRES) - standatone only 
systems 

é) NGS/VE disk driver (file XDISK) 

7) NOS/VE MCU Driver (file XMSPMCU) - standalone onty 
systems 

8) Dual State MCU Driver (file XMCUPP) Dual State 
only systems 

9) Others to be defined later 


If these files are not present in the current user catalogs 
they will be obtained from the appropriate catalog. (le. 
SESsINT2. prefixed procedure calls access INT2 level system 
files onlys while SES» INTI. prefixed procedure calis mey 
access files from either INT2 or INT1 catalogs as is 
appropriate for the system being built.) 


A copy of the linkmap file (linker/!oader output) will also 
be included on the stand-alone deadstart file. A copy of the 
loader directives will be inctuded on the dual state deadstart 
File. These are the Files MAP<offset>K and LOR<of Fset>K 
(descriptions of these files are inctuded in previous 
sections)», and must be in the same catalog as the file 
specified by the 'CPF* parameter. 


The format of the NVESYS is as foltows: 
SESNVESYS € vsn = ¢ tape vsn D Jj 


{ offset = < load offset > ] 
{[ cpf = < checkpoint file name > Jj 
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{ cyblink Jj] 
{C batch J 


ysn 3 The VSN of the tape to be written. This file 
must be available to the operator. The defauit 
is to write the file to a tape as specified 


above. 

offset 3 The load offsets used te determine whether to 
build astand-alone or a dual state deadstart 
file. 
OFFSET = C builds a stand-alone deadstart file 
(DEFAULT) 


GFFSET = 256 builds a dual state deadstart file 
{to use on the $2) 

GQFFSET = 128 builds a dual state deadstart file 
for a 128K system 

GFFSET = 64 builds a dual state deadstart file 
for a 64K system 


cpf 3 The checkpoint file used in creating the 
deadstart file. If the file does not exist in 
the current catalogs it will be obtained from 
the <Integration> catalog. The default is 
LGBOK. 


cyblink ? Option to create a tape for CYBERLINKING to 
CANCCD. The defauit is to build a hardware 
deadstart file. 


batch 3 Run NVESYS in BATCH mode. The default is to run 
it locally. 


2¢GS.3 COMPILING 180 PP CODE (CPP180 PROCEDURE) 


CPP18C is an SES procedure file which compiles 180 PP 
code. The source for the PP code is retrieved from a source 
program tibrary. If the "AB" parameter is specifieds CPP180 
will search this PL First before searching NOSVEPL to satisfy 
externals. The "UN*® parameter specifies the catalog in which 
"AB" resides. NOSVEPL comes from the <Integration> catalog. 


The format of the CPP18O is as follows: 
SESeCPP180 € m = € module name D> ] 


{[ ab = <€ alternate base > ] 
{[ batch ] 
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m 2 The module name of the PP program to be 
compiled. 


ab 3: The alternate base searched by CPP180 to satisfy 
externals before searching NOSVEPL.~ The default 
is to search only NOSVEPL. 


batch 3 Run CPP180 in BATCH mode. The default is to run 
it locally. 


2210 DUAL STATE PROCEDURES 


2210.1 BLDEI PROCEDURE DESCRIPTION 


BLDEI is an SES procedure file which builds the absolute 
file for duel state EI. The AB parameter may be specified if 
a program library containing the dual state EI source exists 
in the current catalog; otherwise 8LDEIT retrieves EI from 
NOSVEPL in the <Integration> catalog. 


BLDEI uses the linker parameter file EILCB to tink EI. If 
this file does not exist in the current catalogs it is 
obtained from the <Integration> catalog by the procedure. 


The outputs of BLDEI include the direct access absolute 
file "EI* and the direct access file ®DSLIST* which contains 
the assembly listing and the tink map for EI. 


The format of the BLDEI is as follows: 


SESeBLDETI { i = € EI source file > J 
{ area = < user name D> J] 
{ batch ] 


i 3 The file in the current catalog which contains 
the dual state EI source program Jibrary from 
which EI is to be bullt. The default is to get 
the EI source from NOSVEPL in the <Integration> 
catalog. 


ab 3 The userits alternate base program Iibrary 
containing new and modified modules. 


area 3 Qption to obtain the object files or linker 
parameter files from another userts catalog 
(other than the current catalog in which the 
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procedure is executing). 


2210.2 OSBILD PROCEDURE DESCRIPTION 


DS@ILD is an SES procedure file which builds the dual state 
binaries XDSTVEs XRUNVE»s and XTRMVE. All assembly and CYBIL 
compilation listings are put on the direct access text library 


fite DSLIST (one tisting per records», each headed by 


the 


corresponding MADIFY deckname) and the three toad maps are 


appended to the compilation and assembly tistings.» 
The format of the DSBILD is as follows: 


SES.DSBILD C€ ab = ¢ alternate base D Jj 
{ batch ] 


ab 3 The userts aliternate base program tlibrary 


containing new and modified modules. 


batch 3? Run DSBILD in BATCH mode. The default is to run 


it focaliy. 


Zell UTILITY. PROCEOURES 


2ellw1 NVEREP - REPORT SYSTEM CONTENT 


NVEREP is a procedure which dynamically oroduces NCS/VE 
build content reports based upon build information contained 
in the Integration procedure tibrary (PROCLIB)»s or that 
generated dynamically by partner procedures. The reports are 


sorted according to a user supplied primary sort keys and 


a 


procedure defined secondary key which is associated with the 


primary sort key. The amount of information contained on 


the 


Integration procedure tibrary is timited by the SES Command 


Languege processor to eighty characterss but the procedure 


is 


sufficientiy generalized to work with expanded information 


produced by partner procedurese These partner procedures 


are 


not of a generalized nature so as to be documented at this 
time (primarily due to a series of deficiencies in the current 


CI tools and conventions). 
The format of the NVEREP procedure is as follows: 


SES.«NVEREP € teft = < primary key > Jj 
{[ right = < primary key> ] 


ae 


Se SBS FH BE £26 BE GH 46 2H £6 2H Sf 46 HO 


on ae 
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left 


{ area = <€ alternate user name > J] 
{ f = < input source > J 

{Co = < output destination > ] 

{[ t1 = ¢€ tibrary name > ] 

{[ print ] 

{ batch ] 


Primary sort key for left side of two paged 
report. Onty the first two characters of this 


parameter are significant. May be either 
MOdules MAdifys Librarys or tLAngquage. (An 
additional options VErsions is onty available 
when used in conjunction with partner 


procedures. Option BUild is under consideration 
for future implementation.) The default for 
this oarameter is MOdule. No validity checking 
is performed for either the ‘fieft' or ‘right? 
parameter valuess and an invalid specification 
will result in a report which may differ from 
that desired. 


Primary sort key for right side of two paged 
reporte.e See parameter feft for valid 
specifications. Default is MAdify. 


Alternate user name to search first for the 
input file specified by the *"f* parameter. 
Defauit vaiue is tnullts and source for *#f! is 
found in the user name where the procedure 
resides (PRCUNAM). 


Name of the file containing build content 
information. Default is PROCLI8B. 


Name of the file to receive the two paged 
report. Default is VEREP. (The files LEFT and 
RIGHT currently remain local after the procedure 
has completed. These files contain the teft anda 
right hand portions of the two paged report.) 


Name(s) of NOS/VE library (or libraries) which 
are to be included in the report. Default is to 
report on all primary NOS/VE Jtibraries. 


Keyword to cause outout file to be printed. 
Default is to not print the report unless batch 
execution has been selected. 


Keyword to cause the batch execution of the 


oe bn 2H 2 oe we 


be 00 206 he Be OH the se ae we Oe ae we 


22 S88 ae 4S 8 eos “ea cO Ge 2a we Ge ee we 


anu 
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procedure. Default is to run the procedure iin 
*LOCAL" mode. 


Zelle2 PROCEDURE GET = GET A LOCAL FILE 


The GET procedure makes some assumptions about Files which 
prove convenient to the procedure writer. The first 
assumption is that any files named by the user represent files 
which are to be modified or interrogated without worry as to 
the access mode of the file (it may be either a DIRECT or _= an 
INDIRECT access permanent file). The second assumption is 
that the file named by the user may already exist as a local 
files and if it does that the current local copy of that file 
is the correct version of that file. The procedure'ts function 
then is to leave currently existing local files alone (unless 
they sare attached DIRECT files)» and find any remaining files 
to add them to the fist of currentiy active focal files. The 

user may wish to specify a search order for the list of files 
to be added to the local file tists and may do so by providing 
a fist of user names (in search orders ieft to right) via the 
‘UN! parameter. The user may also wish to accumulate a number 
ef files upon one filenames and may do so by providing a 
filename for the 'MF* parameter, 


The format of the GET procedure is as follows: 


SES .GET { < tfn > ] § € << pfn > J 
{ <un> ] 
[ < mf > ] 
{[ msg ] 
lfn 3 Local file name by which the file is to be known 


(may be a tist of files). If no filename is 
specified for !fn»s then the filename value for 
the "'PFN* parameter is usede One of either 
*LFN' or *PFNE must be specified. All 
parameters may be specified positionally»s so the 
typical usage of this procedure would be: 
SESeGET (MYFILELsMYFILE2s 222 sete) 


ofn ? Permanent file name of the file to be made 
focai. If no filename is specified for pfny» 
then the assumed value is that specified by the 
‘LFEN® parameter. The tlist of pfn values is 
matched positionally with the 'LFEN* specified 
values. This is illustrated as follows: 
SESeGET (onestwo) (stuf fFlsstufFf2) 


xe we 


C8 28 G26 BH OH HO BE 2H WH BO BH 48 Be CH HO BE OY HE 


ae 


Se be ee £2 28 ae BH BO 


e@ Ga be ow Gh 42H SO 
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un 3 An optional tist of user names which directs the 


procedures search order for files which are 


currentiy not local. This is convenient if the 


user knows that the file exists in one of 
several catalogs» but isn't sure where to look. 
An exampj}e would be: 

SES.GET ipndoc UN=(intlsint2sdevlsdev2srell) 


mf 3 A filename upon which to stack the named files 
(one file per NOS record). For example; 
SES.»*GET (ipndocsbcr) MFebildoc 


msg 3 Keyword which causes the generation of messages 
to describe what the procedure is doinge If for 
exampie the location of a file is in several 
user catalogss the msg keyword would issue 
messages indicating which catalogs (specified by 
the 'UN® parameter) had been searched for the 
files and where it had finally been found. 


Z2ell-»3 PROCEDURE SAVE — MAKE A LOCAL FILE PERMANENT 


Procedure SAVE may be used in conjunction with the GET 
procedure, The redeeming factor about the SAVE procedure is 
that the user need not be concerned about file size. The 
named tocal files are made permanent as INDIRECT access files» 
if possibles otherwise DIRECT access files. Files are SAVE'd 
as SEMI-PRIVATEs READ-ONLY files. This is intentionally done 
to preserve as much precious disk space as possibile» (NOS 
allocates GIRECT access files much fess frugally than INDIRECT 
access files.) Be forewarned that a siight penaity is imposed 
in access time for each sector of disk space saved in this 
manners and that the actual sector savings is only visible 
from the operator's console (not via CATLIST). In the 
procedure writer's world of livings this procedure negates the 
worry of predicting file size prior to creating it. 


The format of the SAVE procedure is as follows: 


SES .SAVE { <lfn> 1 3 € <pfnd J 
{ <un> ] 
C msg j 
{ dir ] 

ifn: Local filename to be made permanente Defaults 
to 'PFN' vatue if not specified. One of ‘'"LFN? 
or tpFN? parameters must be specified. 


Parameters may be specified positionally,s and 


Sd 


SS BH SB 2H 2H SE 2H CO HH HO HH BH OH Be 


ee 
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typical usage would be: 
SES»SAVE (ximmtroxijlins «2. »setc.) 
Permanent filename for files to be saved, 


pfn 3 


msg 3 


dir 3 


201124 NVEMAP 


SES «NVEMAP 


Defaults to 'LFEN*® if not specified. PFN values 
are matched positionally within the tist to LFN 
values. This is illustrated as follows: 
SES.~SAVE (Conestwo) (stufflsstuff2) 


User Name in which to save the Jocal file. This 
parameter is only valid for DIRECT access files 
for which write permission has been granted (Cin 
another user*ts catalog). 


Keyword which causes the generation of messages 
describing the names and destinations of files 
being saved. 


Keyword which directs the procecure to make afl 
named files DIRECT access filess regardiess of 
their size, 


~ REFORMAT NOS/VE LINKMAP 


NVEMAP is a procedure to reduce the number of 
printed pages of a NGS/VE linkmaps while 
maintaining readabilitys and to provide summary 
reports of information contained wihtin the 
finkmap. Either alls or portions of the tinkmap 
may be processed. The reformatted form of the 
linkmap is also suitable for microfiches in the 
format defined for the NOS/VE operating system. 


The format of the NVEMAP procedure iis as 
follows: 


{C i = ¢ input file > ] 

{ 0 = € output filed J] 

{[ area = < alternate user name > Jj 
{ copy = < record count > j 
{[ skie = < record count > ] 
{ print ] 

{C gated ] 

{C fiche J 

C module ] 

{ save ] 

{ two ] 

{C batch J] 


ens wh 44 we we 


ea we wes en we be Se 


oe sa ee 


ae 


26 be 28 Be Be OH 2S Be 


oe £0 be 68 ae BO BH Ge £4 CH GO ae 


2-31 


ADVANCED SYSTEMS INTEGRATION PROCEDURES NOTEBOOK — Build N29 
07/29/81 


2eC OVERVIEW OF INTEGRATION PROCESS 
201124 NVEMAP — REFORMAT NOS/VE LINKMAP 


DOO PEPE PE OTE RE PEPE PE FO FO PE TE FE OO FE FE TD PO PE O8 TE TE FE 8 FE FE 8 8 P88 P86 F088 FE PE 28 FE P88 88 FE 88 88 PO TE EE POE TO PN 8 PE 18 EPO FO PDO AE 


area 


copy 


skip 


print 


cated 


Pi] 


oe 


Input file which contains generated output from 
the execution of the NOS/VE CI Cor SES) Linker. 
Default is MAP256K for systems prior to the 
system restructure (Prior to Build OO)» and 
MAPHXX for restructured systems. 


Name of the output file to receive the 
reformatted flinkmap file. Default is to produce 
aiocal fiite of the same name as specified by 
the 'i' parameter. 


Alternate user name to search for the input file 
specified by the 'i* parameter. Default value 
is null’, 


Count of the number of NOS records to process 
from the current file position of the input file 
(default position BOI). Each invocation of the 
finker produces a new record upon the output 
file. Thuss to process only the first portion 
of the Jinkmap (typically Monitor for the NOS/VE 
Operating System) '#COPY=#1" would be specified. 
Default value for this parameter is to process 
the entire linkmap BOI to EQI. 


Count of the number of NGS records to skip prior 
to processinge For the NOS/VE operating system 
*SKIP=2* would suppress the Monitor and EI 
portions of a  Duai State tinkmap. *SKIP#2 
COPY=1" would process onty the Task Services 
portion of a Dual State ltinkmap. Use of either 
the 'skip! or ‘copy! parameters infers explicit 
knowledge of the content the linkmap. Due the 
the number of variations of tinkmap which can be 
produced it would be impractical to generalize 
these parameters in a more logical manner. 


Keyword to cause output file to be printed. 
Default is to not print the reformatted 
finkmap.» "'PRINT=TWOMAP!? will print the contents 
of file named TWOMAP. Key =*PRINT® will print 
TWOMAP if key "'TwO" is also specifieds otherwise 
the file specified by the 'o' parameter will be 
printed. *PRINT#ALL® will print both TWOMAP and 
the File specified by the 401 parameter. 


Keyword which eliminates information for afi 
entry points which do not have the GATED 
attribute. Conceivably» a combination such as 


ee C4 Be be tw 
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'SKIP#2 COPY=1 GATED* would produce information 
to a compiler project about which entry points 
within Task Services are GATED for their use. 
Default is to produce reports of all system 


entry points. 


Fiche 3 Directs the procedure to place the output of the 
procedure onto the file NOSLIST for subsequent 


microfiche processing. Defauit is to not add 
the linkmap to the NOSLIST file. 
module 3: Keyword which causes the removal of all entry 


point information from the finkmap. This proves 


useful for auditing module attributes. 


The 


defauit is to retain all system entry point 


information. 


Save 3 Keyword which causes the output files to be 
retained on permanent files for subsequent 
inspection. This option is selected if batch? 


has been specifieds, otherwise it is left to 


the 


discretion of the user to dispose of the focal 


copies of the output files. 


two 3 Keyword which directs the procedure to twopage 
the tinkmap onto the file TWOMAP. TWOMAP will 


always be generateds but will only contain 
summary report information unless ftwot 
specified. This twopage option is not 
familiar SES TWOPAGE options but rather 


the 


is 


the 


a 


computed spiit and merge of the reformatted 


MaDpPe 

batch 3: Keyword to cause the batch execution of the 
procecure. Default is to run the procedure in 

*LOCAL* mode. 
This procedure will always produce two output files. The 
primary output file is governed by the ‘tot parameter. A 
secondary output 'TWOMAP4 js always produced as well. The 
TTWOMAP? file will only contain the summary reports) and 


floadmap If parameter 'two't is not selected. The first summary 
report which is produced is a two paged report of  PVAs_ found 
in the tinkmap. The teft hand portion of this report is a 
sort by PVA. The right hand portion of this report is a sort 
by module and/or entry point namee This report should answer 
the questions: 1. Given a PVA» in which module and/or 
procedure is that PVA contained?s 2-2 Given an entry point 


names in which moduie is it defined and what is its PVA?» 


and 


oH a6 BY wm on we GH BH we 


men eh ee oe he 


ae OH of whe Be Oe 
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36 Given the name of a variable within a system defined 
tables what is its location within a dump? 


The final report is a two part error summary for the 
linkmap.e The first portion of this report Identifies which 
pages of the linkmap contained one or more errors. The second 
portion of this report is a list of af_l of the errors found 
within the tlinkmaps in the sequence in which they appear in 
the map. 


a the 


ee oe OC 66 Oe 
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300 DUAL _STATE_INSTALLATION SEQUENCE 


This section describes how to install allt of the files 
needed to run NOS/VE In Oual State modes. To do this from 
"scratch® the following materials are necessary: 


1 HIVS tape 
1 Dual State NOS Deadstart tape 
~ The LOADPF tape(s) which contain the NOS/VE environment 


TF HIVS and CTI are already present and corrects then it jis 
oniy necessary to install a new deadstart sector on disk or to 
fjoad a new NOS/VE environment. If A170 NOS has been run on 
this machine prior to the installation of NOS/VE» then chances 
are excellent that the proper versions of HIVS and CTI were 
useds 


31 CLEAR POINTERS AND INSTALL CTL 


To clear the poitnterss deadstart from the Dual State NOS 
Deadstart tape which is NT» D=PE» FeI»s LB*KUs and enter? 


UR — D> KL Fe——D>R (Release) 
Channel=xx 

Eq=xx 

Unit=xx 


Deadstart again from the same deadstart tape as above and 
then enter? 


KY F——— D> *T K———-D (CR) CInstali D/S module on disk) 
(CR) (Proceed - Response to warning) 

Channel=xx 

Eq=xx 

Unit=xx 


3e2 INSTALL _HIVS 


To instal! HIVS»s deadstart from the HIVS tape which is NT» 
D=PE, F=SIy LB=KUs and then enter: 


*U%*—--—->*T* (Select TDX option) 
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C$? option (Bulild directory in CM and copy to disk) 

Disk type=x 

Disk Channel=xx 

Disk Eq=xx 

Disk Unit=xx 

MT type=3 

MT channel =xx 

EqQ=xx 

Unit=xx 

User type=z02 (Shared 0/5) 

Install optionss02 (Edited MSL) 

Cptions=01 (Build without D/S sector since it was 
already created by CTI.) 


When END appearss HIVS is installed, 


363 JNSTALL SYSTEM 


Deadstart from the NOS Dual State deadstart tapes using the 
deadstart tape which is to be instatted, Choose the ‘0? 
option on the first displays for operator intervention. Then 
choose the 'H!# option on the next display to see the hardware 
parameters. Enter CM2=10000. Optionaliys, the *#P* display may 
be selected to choose a CMRDECK. (CMRDC14 contains the CANCOD 
$2 configurations CMRDCK6 contains the ARHOPS $2 
configuration.) Hit carriage return. The system will 
display: 


ENTER LOCATION 
OF MSL/HIVS DEVICE 


Enter the information for the same disk where HIVS was 
installed previously: 


Channel =xx 
Equipment=xx 
Unit=xx 


After the system is deadstarteds», enter the fottlowing 
commands: 


XeDIS. 
COMMONS SYSTEM. 
INSTALL sSYSTEMsEQxx. 


NCTE: xx is the EST ordinal of the disk where the deadstart 
sector is to be installed; this is the same disk where HIVS 
was instaited previousty. 
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304 LOADPE_EILES 


The LOADPF tapess which are NTs OD=PEs FSI» and tLB=KlL>» 
contain the NOS/VE operating system source and binariess tools 
to assembfie and Jink the operating systems and various other 
files. 

Deadstart from the disk upon which the NOS Dual State 
system was installed and LOADPF the files to the desired user 
number. 

Check the indirect access file CMDS1 to make sure it 
reflects the hardware configuration? 


*RELOADCH=x, x should be an empty channel, 
*DISKCHeylsy2. NGS cannot use channel yl or y2 with Duel 
State active. 
*SYSTsDISKUZ=0N., Zz can only be 0 through 3. 
(Unit 2 on channel yl or y2 cannot appear 
In the NOS CMRDECK or EST.) 


365 BRING UP_DUAL_STATE 


After the NCS Dual State system has been deadstarteds and 
the Dual State execution environment has been instalieds 
NOS/VE is brought up by entering the following console 
commend: 

XeUPMYVE(CAT=c) 


where: c is the user number in which the execution 
environment was =instaited. Enter Kosntne (n = the control 
point number of the UPMYVE job) to see the NOS/VE display. 
K»*BYEVE. followed by «.*ENDRUN. will terminate NOS/VE. 
For further information regarding the operation and execution 
of this environment refer to the S2 Machine Usage Documente 
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4-0 NOSZVE HARDWARE REGRESSION TESTING 


4o1 INIRCDUCTION 


The verification currently performed on NOGQS/VE systems 

consists of the following: 

1) running the simuftator test input contained on file 
VOLTST3 until visual examination of the output from this 
test warrants that further testing should be performed» 
and 

2) running the S2 Regression Test Sequences as outlined in 
the following secticnss on the hardware, ; 


4e2 32. REGRESSION TESTS 


4e2e1 TESTBAM 


TESTBAM is a file containing the statements necessary to 
execute all of the BAM test cases supplied by We Vs. Mahal. 
These procedures exercise various portions of the basic access 
methods and are used to show some level of confidence that BAM 
works as well as it has previously. The command sequence 
follows: 


LOGIN USER=DEV NAME=TESTBAM 
LIUs,USER=A(DEVI»yNVE)» PA=DEVIXs AZNOTUSEDs PR=NOTUSED 
GETsSYSLIBs SYSLIBs»sNVE»B56 
GETsCYBILIBsCYBIILB»s s»sNVEsB56 
SETLOBJECT_LIST ADD=SYSLIB 
EXECUTEss»ssBAMTEST 

TES1 

TES2 

TES3 

TES4 

TESS 

TES6 

TES? 

TES8B 

TESS 
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TES10 

TES11 

TES13 

TE S14 

TES15 

TES16 

TES20 

BAMSTOP 
GET»SCL180sSCL180295NVE»B60 
SUBMITsSCL180 
JMEXIT 


4e2e2 JOBI 


JOB1 is a File containing the NOS/VE commands which stage a 

CI object file from the 170 side to the 180 sides convert this 
file to an II tibrary files and replace the II tibrary on the 
170 side. It tests the following NOS/VE features: 

LINK USER command 

GETPF Bé0 

CITOII conversion 

Dbject Library Generator 

Display Library Information 

REPLACE 856 

JMEXIT 


The command sequence follows: 


LOGIN USER=DEV NAME=J0RB 
LIUsUSER=(DEVI»sNVE) » PAZDEVIX »sA*®NOTUSED,s PRaNQTUSED 
GETsCITEXTLBO»sCYBILGOs »ssNVE»B60 
EXECUTEss*CITEXTLAOsIITEXT1IB80' »ss,s,CITOLI 
EXECUTEss90sCOL 

ADDsFeIITEXT180 

OTS,»,ON=ALL 

GENERATEsLIBRARY=LIBRARY180 

QUIT 

REPLACEsLIBRARY1 8OsCYBIILBss »NVEs8 56 
GETs JOBZ2sJDBZ2 »9eNVEs BEC 

SUBMIT, JO82 

JMEXIT 
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4e2e23 JOBZ 


JOB2 is a file containing the NOS/VE commands which stage 
an II tibrary and aCI user job object file from the 170 side 
to the 180 sides convert the CI user job object file to an MII 
object files and then toad and execute this user job with the 
library. It then stages the LOADMAP back to the 170 side to 
be printed. JO0B2 tests the following NOS/VE features? 

LINK USER command 

SET_LOBJECT_LIST command 
SETLPROGRAM_GPTIGNS command 

GETPF B56 

GETPF B60 

CITOII conversion 

Load/Execute User Program + Library 
JMROUTE C180 print file 

JMEXIT 


The command sequence follows: 


LOGIN USER=DEV NAME=J0B2 

LIU, USER=(DEVI»NVE) » PA=DEVIXs A=NOTUSED» PR=NOTUSED 
GET»sNEWLIBRARYsCYBIILBss»NVE» 856 
SETLOBJECT_LISTsADD=*NEWLIBRARY 
SETLPROGRAM_OPTIONS»sMO=(BLOCKsENTRY_POINT» XREF »s SEGMENT ) pees 
TERMINATION_ERROR_LLEVEL=FATAL 

GET» XPETESTsXPETEST»»»NVE 2360 

EXECUTEs»s *XPETESTslL GO sssCITOII 

EXECUTE LGD 

JMROUTEsNOTUSEDs LOADMAP»sPR 

GETsCYBILIBsCYBIILB»s »s»sNVEsB56 
SETLOBJECTLLISTsDELETE=ALL 

SET_PROGRAM_OPTIONSs TERMINATION_ERROR_LEVEL=ERROR 
EXECUTE LGO 

JMROUTEsNOTUSEDs LOADMAP sPR 
GETsTESTBAMs TEST BAM» » »NVE » B60 

SUBMITsTESTBAM 

JMEXIT 


4o3 32_ REGRESSION TEST _SEQueNce 


1) Mount the disk labeted “DAHL-Large sector" on 844 Unit 
CO. QGther disks will not work. 


2) Deadstart A170 NOS: 
- Set the deadstart panel to disk deadstart from? 
CHel 


<% 
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UNIT=41 
WORD 1320006 

- Push deadstart button. 

~ Select *0* display. 

-~ Setect *H* display. 

- Enter CM=100C0 

~ Hit carriage return. 

- Enter date/time. 

3) If necessarys update the INT2 catalog and toad the 
fatest system files into the INT1 catalog: 

- Mount the INT1 and INT2 cataiog DUMPPF tapes. 

- xX,DIS. 

USERsINTlaINT1X. 
SES.UPCATS <INTl=tpuld <INT2=tpu2> <SYSEDIT>S 
Hit ™." to go into AUTO mode. 
DROP. 
The SES.UPCATS procedure works as follows: 

a) Updates the INT2 catalog by retrieving the "fast 
files" {(CMIMAGEs PPIMAGEs RGIMAGE) and CYBIILB 
from the INT1 catalog and by foading selected 
Files from the DUMPPF tape mounted on the unit 
specified by the "INT2" parameter. This parameter 
must be specified for the INT2 catalog to be 
updated. 

b) LGADPF's the tatest system into the INT1 catalog 
from the DUMPPF tape mounted on the unit specified 
by the "INT1" parameter (defaults to "50"), 

c) SYSEDIT's the A170 Remote Host and Interactive 
binaries if the “SYSEDIT™ keyword is specified. 


4) Bring up dual state: 
XeUPMYVE(CAT=INT1) 
Keane (where "n®™ is the UPMYYVE control point) 


5) Test if paging 1/0 is working? 
KeDECLARE P POINTER. 
KeSMCPEN P, 
K.CM P /*1234/%. 
-> Disk unit light should flash on 844 Unit 0. 
KelM P 100. 
-> If system is hung at this point then paging is 
not working. 
KeSMCLOSE Pe 


6) Bring up A170 Remote Host and Interactive: 
TAFNVE. 


7) Bring up C170 Remote Host? 
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X¥.DIS. 

USER »INTL»INT1X. 

GETsTESTBAMsJOB1sJ0B2. 

ROUTEsTESTBAMs,DC=LP,FC=RH. 

ROUTEs JO8ls»DC=LP»FC=RH, 


NOTE: JCB2 uses the output of JOB1L in its execution; 
hence J0B2 cannot be ROUTE*d until JOB1 finishes. To 
determine when J081 is finished: 
- Hit "*" key to return to K-display. 
The JOB1 dayfile will be displayed as the job is 
runninge When the system has executed the JMEXIT 
statements, J0OB1 has finished. The J0OB1l dayfile will 
then be staged back to the 17C side to be printed. To 
print filess do: 
~ Make sure the printer is on (i.e. the START tight 
is fit). 
- FOQRM3291TM. 
ON32Z.6 
(The dayfiles of the TESTBAM and JOB2 jobs will also be 
printed when these jobs finish.) 
Now JQOB2 can be submitted: 
- Hit '*" key to return to OIS. 
~- ROUTEsICB2,DC=LP,FC=RH. 


DROP, 
The JOB2 dayfile will be displayed as it is running. 
When all jobs have finished executing and their 


dayfiles have printeds then NGS/VE and Remote Host may 
be terminated by doing the following: 

2eSTOPe. (bring down TAFNVE) 

K»*BYEVE. 
When the K-display displays the message that NOS/VE has 
terminateds type: 

Ke *ENDRUN. 


10) Bring down A170 NOS? 
AB. 
CHECKPOINT SYSTEM. 
Ey-M. (make sure that alt’ checkpoints complete) 
STEP. 
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404 THE CONFIDENCE TESTS 


The Confidence testbase contains a set of tests which are 
to be run after each build. These tests are created by the 
GENTEST procedure. This procedure MUST be rerun after any 
change to OSLPI or the CI CYBIL compiler. The GENTEST 
procedure is designed to be run on S/N 101» but can be run on 
the S2-. 


4o5 CONFIDENCE TEST SETUP _INSTRUCTIONS 


Do this setup procedure when the OSLPI» the CI CYBIL 
compilers, or the confidence testbase changes. The GENTEST 
procedure may be run on the NOS state of the CYBER 180 or on 
any NOS system with the tastest CI CYBIL compilers, OSLPI»s and 
the confidence testbase PL(CONFPL). 


4051 FILES NEEDED TO RUN THE SETUP CONFIDENCE PROCEDURES 


To run the confidence test setup procedures the foltowing 
files are needed: 


CYBILI/UN=INT1 
CSLPISUNZINTI 

CONFPL/UN=INTI 
CYBILC/UN=DEV1 


4.522 RUN ON A NONE CYBER 180 


1. Login to the same user as the test are to be run under on 

CYBER 186C. 

2e Enter SESsINTI.GENTEST (8A001.2.GENCVRT) 
{See section on GENTEST for more detaits.) 

The test will generate a set of Xfiles containing the 
binary file for each jobs» also the CYBER 180 job will 
be appended to the 180 toad file(tl0180). If it is A170 
and 180 interacting test the jobs will be appended to 
A170 toad file(LlD170). 

3 Dump the files to tares use the SES~DUMPPF 
procedure. 


You will then be ready to run the test on the CYBER 180 
after loading the dump tape. 
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4%e5e3 RUNNING ON A CYBER 180 WITH NOS/VE UP 


After loging in to the user which the testbase is to be run 
under do the following: 


SESsINT1.GENTEST (BA001..GENCVRT) CHAROFF 
(See section on GENTEST for more details.) 


4e6 CONFIDENCE TEST _ OPERATOR INSTRUCTIONS 


1. CDeadstart the Dual State NOS system. 
22 Load files into the INT1 catalogs if necessary: 


Vsns<tape unitds"vsnname”™,. 
%edis. 
usersintlsintlx. 

ENTER 
requestsdumpsntsd=pesfesisibzkisportrsysn="vsnnam". 
loadpf. . 
drop. 

OR ENTER (can be done from a terminal aiso) 
sessintl.loadpf vsne"vsnnam" 

3e Bring up NAM, 
4. tLoginsintlsintlx. 
5e Bring up VE and IRHF. 
6. Run 180 tests from terminal ). 
SESeLDTEST 
{See section on LOTEST for more detaits.) 
7e To get 170 fistings. 
On32e 
Form329-. 
8. To get 180 fistings. 
on32. 
Form32stme 


4.7 CONFIDENCE TESTBASE. PROCEDURES 


4e721 GENTEST 


This procedure will generate a set of A170 and/or C180 toad 
files from a testbase prooram library (PL). The default Pl is 
the confidence testbase on UN=INTI1. 
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The format for GENTEST is as following: 


S€SsINT1.GENTEST test = <test_name> 

base = <file name> ] 

1d170 = <filie name> ] 
1d18O = <file name> J] 

un = <user_ name> Jj 

{fc = <leading character> ] 
norun J] 

charoff ] 


eo“ arr ee es 


test : deck +: d i t im 3: The test which will be 
generated from the base PL. This parameter is 
required for running of this procedure. 


base : 4% ¢: pl i? b : The file name containing the 
confidence testbase. The default is the file name of 
CONFPL. 


14170 17 3: The file to get the 170 and 180 
interacting tests. The default file name is LD170. 


1#d180 ; 18 t The file to get the 180 tests. The 
default file name is L0180, 


un : The user name which contains the CONFPL file. 
The default is the owner of the procedure. 


ic : The leading character of the confidence testhbase 
PL. The default is a 7.» 


norun ¢ nr : This keyword when used will create a 
load file on the LD17C0 file onty. The default is not 
to use this parameter. 


charoff { choff : This keyword when used will run the 
tests. These keyword when used without the NORUN 
keyword should only be used when on a Dual State NOS 
system and NOS/VE is up. The default is not to use 
this parameter. 


Example: 


SESasINT1L.~GENTEST (BA001..GENCVRT) 
(This will cause all the A17C jobs to be run and the 
C180 jobs to be saved on the LD180 file.» Also the 
A170 and C180 interacting tests to be saved on the 
LD170 file.) 
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SESsINT1L.~GENTEST (BACO1..«GENCVRT) CHAROFF 
(This will generate the complete testbase creating 
the A170 job which will route In a C180 job when the 
supporting binaries are created. This exampie will 
only work if running on a dual state NOS system = and 
NOS/VE are up.) 


SES» INT1.~GENTEST (BA001.2e+GENCVRT) CHAROFF NORUN 
(This wild generate only the LD170 toad file for the 
LOTEST procedure. The A170 part of the test will 
route the C180 job after the supporting binary files 
are created on the dual state NOS system.) 


This procedure will load a set of tests from two toad files 
{ one file containing oniy C180 jobs and the other file 
containing jobs interacting tests between the A170 and the 
C180). The procedure has three speeds of loading (fasts 
normals, and low). It aiso has the option of reloading ail the 
tests as many times as wanted. 


Format of LDTEST is as follows: 


SESsINTI.~LDTEST €£ 1d180 = <file named ] 
{ 1d170 = <file named ] 
{ speed = <high : normal i: tow>d J 
[ loop = <loop_count> ] 


1d180 3 18 3: The file containing the CYBER 180 toad 
file produced by the GENTEST procedure. Default is 
LD18C on the current user catalog. 


1d170 $ 17 : The file containing the CYBER 170 toad 
file produced by the GENTEST procedure. Default is 
LD170C on the current user catalog. 


speed |} sp : The speed at which the tests will be 
loaded in to the system. The procedure will onty 
test the first tetter to get the values The 
alfowable values are F or H for high speeds M or N 
for normal speeds or any other tetter for tow 
speed. The default is normal speed. 


foop ; ip 3: The number of times the compliete 
testbase will be foaded into the system. The 
default is only one set of tests. 
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Example: 


SES.~LDTEST 
{This will Joad one complete set of tests in to the 
system with a normal wait between toading each test 
jot.) , 


SES~LBTEST SP=H LOOP=3 
(This will foad three complete copies of the 
confidence testbase with a one second rollout between 
Joading jobs. This can be uses to toad down the 
system.) ; 


4.8 CONTENTS _OF_ THE CONFIDENCE _TESTBASE 


BAM Tests 
BAOO1 Issue and verify amp$file and 
amptget_file_attributes. 
BAGC4S Issue and verify amptget_file attributes and 
amp%fetch for default and modified attributes. 
BAO023 Verify record movements, data integrity and file 
access changese 


Condition Handler Tests 
CHOO1l Test pmpScontinue_to_cause from specific handler to 
a handier for all system conditions. 
CHO06 Produce various error codes connected with condition 
handier procedure callise 
CHOC8 Test that the appropriate error code is generated 
when pmp$continue_to_cause is called. 


SCL Tests 

CLO16 Test cip#deciare_variable and clptremove_varlable 
with Test ciptremove_variabie for an 
undeclared variatle and for a task variable. 

CtL017 Test string length boundaries in 
ciptdeclare_variable. 

CLO18 Test cip$decitare variable dimension boundaries and 
dimension with all command languages. 


Loader Tests 
LOCC] Test static and gitobal pointer initiatization. 
L0002 Test XDCL procedure by using large array parameters. 
LDO003 Test linking a user task to procedures in task 
servicese 
L0004 Test ftinking a user task to procedures in task 
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42G NOS/VE HARDWARE REGRESSION TESTING 
4.@ CONTENTS OF THE CONFIDENCE TESTBASE 


services. 


Remote Host Tests 


RHOO5S 


RHOO06 
RHOOS 


~ RHO10 


GENCVRT 


Test repiace 
involveds 
Test replace 
Test replace 
involved. 
Test replace 
involved, 


existing file with no conversion 


existing file with conversion involved, 
non-existing file with no conversion 


non-existing file with conversion 


Set up for remote host tests. 


409 CONFIDENCE TEST BASE MAINTENANCE 


When new tests are added or old tests are removed from the 
confidence the following maintenance is needed? 


This 


document the new test description must be added or 
the cld description must be removed. 


The CONFPL the new deck must be added (see section on 
maintenance of the CONFPL) or the old deck removed. 


The GENTEST procedure must have the new deck name added or 
the oid deck name removede See the section on maintenance 
of the GENTEST procedure. 


4.9.1 CONFPL MAINTENANCE 


When adding a new test to the confidence testbase the test 
should have the folfowing calf: 


/CALL USER170 after the A170 job card 


/CALL T0180 the 


last card in the A170 jeb 


/CALL USER180 after the C180 LOGIN 


The A170 job should NOT have any of the following commands? 


SES .PRINT 


ROUTEsfilesDC=PR»sFC#HR. 


DEFINEs SAVEs or REPLACE 
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The SAVEs REPLACE, or DEFINE should be replaced be a 
SESsINT1.~SAVEPF call before the /CALL T0180. 


4.922 GENTEST PROCEDURE MAINTENANCE 


As new test are added to the testbase the GENTEST procedure 
is the onty procedure which will needed any maintenance. The 
section of the GENTEST procedure which will change is the test 
names « The following is tines are those which will be 
changed? 


e*BAOCLRUN? 


» 


="RHOOSSAVE! 


* 


=*GENCVRTRUN?! 

=n 
The RUN perameter is for any job which has an A170 job to 
produce a file for the C180 test. 


The SAVE parameter is for A170 and C180 interacting tests. 


The n is the count of the last job which can be loaded. 


(2) 
(3) 


(4) 
(4) 
(4) 
(4) 
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(1) NOS/VE_ Transmittal Form 


Originator. — DATE __i¢# t/t «=O arget Build 


Code Location: (PACKed Modsets) FN= UN= 


(Decks in "GROUP" format) FN= 


PR eae See ei PORE | |) cere eR er RnR ee 


Code Descrietion File: FN= UN= 


i a i a a a a a ae > con ep ie ae ee came ee 2 ee ee 


Code affects system usere yes 


Usage Changes Description Filet FN 


Modset Identifier(s) 


Code Destination (if not NOSVEPL)?: PL= 


A SRS AN EE END EE AA SND A AD AE A ED EE ENS SE ~NNS O ON <N O  - 


New Feature [ J Resubmittal ff _._] Corrective Code [ 


J 
NOS/VE J A170 NOS C ] Dual State f€ ] 


PSR{s) Answered 


COMMENTS _TO_INTEGEATION 


Instaittation procedure changes required? [C .._] 
Dependent upon other features Fixs or tool? { ] 
Documentation changes required? ere | 

OSLPI or Internal Interface changes required? { 


Module(s) te be recompiled 


Has this code been tested? yes 


Notes regarding code submittal: 
(1) Use right margin of form if more space needed. More forms 
are on FN = XMIT1O UN = DEVI. 
(2) Attach copy of description file to form (both 14 778 by 11). 
Format is? #MOOSET_LIDENTIFIER (Cor NEWLDECK_ NAME) (upper case) 
Descriptive text which describes code content 
** DECK MODIFIED (or NEWLDECK_NAME) (upper case) 
(3) Indicate whether this code implements changes that will affect 
a system user. Specify the location of the file containing 
descriptive text describing how the user jis affected. 
Attach copy of this file to Form (both 14 7/78 by 11). 
(4) If any of the above are checkeds then explain below. 


Code Reviewer 


ae 


an 2G #84 SO 


oe £26 © S26 £6 


Bl 
07/29/81 


Request Number 


SODEITWARE_ CHANGE REQUEST 


software Needing Change 


ooo | need 2 . oo | 
NOS System H : Integration ; H Stand-atone i H 
tent Catalog $+ NOS/VE fom 4+ 
+$—--=—+ oo o $m mmm} 
Instaltlatior H ; Product Set : : S2 Prototype 3 H 
Procedures foment t----+ Ciosed Shop tem + 
fmm + $o--=—+ $m 4y 
SES 3 ; A179 NOS i H Dual State 3 H 
Tools tes St System aaah | System $e oe—+ 


TYPE_OF_ PROBLEM BEING _EILXED 


$——--+ $a + $————+ 
Critical Fix 3 ; Major PSR ; H Other 3 H 
oS $--—=+ oe | 


DESCRIPTION _OF_ CHANGE 
Modset Identifier(s) LL Neale acres ed aN oe Saeee eeat ER ee En, TE 
Deck(s) Modified JUL Pie ake ree eda a at a Ses et occas ae a a Sgr eee ad aves ee 


{include all 
common decks) 


DESCRIPTION OF PROBLEM BEING _EIXED 


Approved By _ ooo ate ee oh Be cect oe eae 


ee 


om ba 


B2 


07/29/81 


INSTRUCTIONS 


The purpose of this form is to initiate a mini-build of the 
requested changes into the current build level. The scope of 
the changes requested and the impacts of making these changes 
must be adequately described. This is the only way to make 
changes to a system after the feature code cutoff for that 
build has occurred. 


Requestor: Name of the person submitting the change. 
Date? Date of the request. 
PSR Number? Number of PSR being fixed. 


Check those which agply 

SIN.101_System: Change affects the closed shop NOS system. 
lotegration Catalog: A correction is necessary to the INTIly» 
INT2s DEV1s or A17OINT catalog(s). 

Stand-alone NOS/VE: Change affects only the Virtual State 
execution of NOS/VE. 

Installation. Procedures: A correction to the existing 
Instaliation Procedures is necessary (iee such as moving a 
module to a different library) 

Product Set: Change affects an assembler or compiler. 

S2 Prototype Closed Shop: Change is necessary to the system(s) 
provided in the S2 tab. 

SES_Tools: Some change is necessary to the SES tools used _ to 
generate systems (ieee Linkers Loaders Simulators etce). 
AL7O_NOS_ System? A change Is required to the A170 Version of 
the NQS operating system. 

Dual State System: Change affects the Dual State software. 


Critical Fix: Fixes a problem which cannot be avoided either 
operationally» or programmed around. 

Major PSR: A serious problem for which a PSR exists and is a 
considerable nuisance to system users. 

Other: Fixes to nuisances or time wasting problems. 


Modset_ Identifiers: Name of the modset(s) which need to be 
added to the affected software. 


Cecks_._ Modified: Name(s) of module{s) which reauire 
recompilation or assembly as a result of this change. 


Description. of Problem: A description of the severity of the 
problem being fixed» and the scope of the changes caused by 
integrating this change. 


Approval: Authorization signature for the changes currently 
requires Tele McGee approval for NOS/VEs and JeM. Graffius 
approval for A170 NGS. 
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> USER : 
: NUMBERS  $ FILENAME(S) : 
he ee ae een ee ee ee 
INT1 ! NOSVEPL 
DEV1 : 
i 
INT1 ! OSLPI 
DEVI 
) : 
0 a nae a AO cm a Ce ee & 
INT1 1 VELTOPL 
DEVI 
“See iS sam aes si hee ae nee ee eee oe ee ae ee ee ee ee ae eee oe wae 
AI7OINT  $ A1700PL 
LIBRARY OPL 
wae ene + 
INT2/INT1 $ PROCLIB 
DEVI : 
: 


O64 ae oe Oe Oe ee Oe oe be oe oe oe oe ee ee we eb bp ae ht Oe a ee de a Oe Oe ee he we ee ee he oe ee we nw ee ee 


208 26 we 26 we Bh Be hh oe Ae He ee we Oe hh ee Oe Oe HO ee He oe ee mw 


INT1 ! NOSLIST 
DEV1 ; 

SA AAR OLED «CAND CA A “SND en EERO «ON + a CUED ORD NERD seme GND “AERP SED a ce OT WE ae “ep am TEED ame - 
INT1 ! MTRLCBsEIELCBs 
DEV1 : EILCBySTSLCB 

! LIBLCB 

A a se ae a a co OO a ee an ae ee a a a ae eee ne en 
INT1 $ NEWDKPL 
DEV1 ; 


FUNCTION 


MADIFY program tibrary 
of Virtual State code 
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MADIFY program library 
of NOS/VE Program 
Interface decks. 


SP AS A A AEP ORES AED a AN EN SE enn ease ite EP am aang ame cena signa ED RD SEED RES A 


ADIFY program library 
f NOS code which 
upports NOS/VE. 


“uo = 


DEED A AS TP A A EE ED OS ED A DE Dy a 


MODIFY program tibrary 
which matches NOS 

system level for S2. 

(Installed on FMD 

unit 43). 


Command Language 
Procedure Library 
{Documented in 
Integration Proced- 
ures Notebook). 


a 6D ee ae ee se oe ee ee ee ee ee ee es 


Contains compilation/ 
assembly listings of 
all Virtual State 
code. Accessed via 
LISTNVE procedure. 


i ee ae aap ae “AED GED A ED ED aS AS AED EP ED ED A A  -aD D 


Linker directives files 
for monitors 

error interfaces 

task servicess and 

user modules 
respectively. 


AS AD Se A A ED A ae ED A ED VE ND ED ED Oe A Ee a a a a a 


Meaningless Madify 
program tlibrary 

which users may 
substitute for 

as an alternate 

base when using 
Integration compilation 


 VERSION/FREQUENCY OF UPDATE 


Matches the levei of system 
binaries contained in same 
cataloge Updated on periodic 
scheduled basis. 

atches the tevel of system 
inaries contained in same 
ataliog.e. Updated once for 
ach build cycie. 


oo oy & 


atches the level of system 
inaries contained in same 
stalog. Updated on 
ectesvs scheduled basis. 


“ndeted on a scheduled basis. 
(CPUMTR which supports NOS/VE 
is on VEL7OPL and pot 

on this PL). 


Matches the level of system 
binaries contained in the sam 
catalogs» and accesses the 
appropriate build tool 
versions. Scheduled updates. 


Matches the level of system 
binaries contained in the 
same catalogs 


Matches the level of 
system binaries contained 
in the same catalog. 

EI is built using the 
BLDEI procedures while 
NVEBILD is used for EIE. 


evers disappears when SCU 
onversion is complete. 


QO 2 


oe oe oe we we on oe oe OE we Oe oe we } OF OF be Oe OH hp He Oe ee Be oe ob oe Oe we we ow Oe we oe oe be ow Oe Oe oe > Oe Oe oe ow oe 
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Files mainteined ty Integration 


S 


> ee oe ae oe ee be ee 4 ee ne ee ee oe he Oe 6 ee Oe oe a ee a oh oe 


curce Files 


i sane ee ee ae i ee ee a a 


INT2/INTI 
DEVI 


a ee ee ER ee ee ee 


INT1 
DEVL 


A ne Ta eh etn male eat “AEN ap cenae seein 


on ae Be ee hh we we oe > we ee a ee ae ee ee ee 


MAP<offs et>kK 


VQLTST3 


Pe ND OE ls EE ED “OE ee ae A ne a ee Se “A 


LDOR<offset>K 


AP SEE HAR OES ED OE AS ED ED A OD De OE ee ee 


KEYDESC 
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Fach Vetink of a Dual 
State system. 


Contains link map of 

Dual State system 
createds where MAPOK 

is a standalone NOS/VE 
system and MAP256K 

is a 256K NOS Dual 

State system, 
me ee ee ree ee ee we ce ce ee ee ee ne en ae a 
Contains simulator 
commands for a 

batch mode test 

of the NOS/VE 

Sret ere 

Contains VE auweraenn 
directives for Dual content or structure 

State offset loads. changes. 
a i a ate ce ae ee ae ca a a ee ac ae ee ae ae he Se a eS A A A A 
; Contains Keypoint :; Non<standards updated 
descriptions for upon development!s request. 
the Keypoint report 
+ program XXM7KEY. 


ee ee ee ee ee ee! 


A SRD OTR AED ED AD SAE “AOD ENE NERD EA LET SE A EY ND ONO SOND SAD ND AND AND ENED <A A ND NOD ER Ny RD alae ON ae 


As required by system 
content changes. 


SR Ne Ee ER A SO I 2 ANS ee A ee 


As required by system 


OO we Oe ab We we Oe Oe a hh Oe ee ee i le 


SO we we dh oe a me ae 


ewe @u & 


eon ae & 
> we we ae we dp oe ee oe hh Oe Oe oe we be dh) he Oe be Oe oe oe ne ae th oe 


Files maintained by Integration 


Dbject Text Files 


INT1 XLMMTR 

DEV1 

INT1 XLJLLF»XLJ12E 
DEVI XLJ13F 9 XLJIFF 


ee ee ee ee ee ee ee ee ee ee eT 


; ; 

H H 

H ; 

H ; 

H ; 

+ + 

H ; 

; H 

H H 

; ; 

H H 

: : 

+ + 

INT1 ; XOLEsoXSCL» H 
DEV1 ' XLLMCII H 
: 3 

: ; 

i ns i ai See ssa a a gc + 
INT1 ; XUCNTL» XUTEST» : 
DEV] § XUSORTsXUUXERL, 3} 
: XUUTL»s XUVLEX >» ; 

: XUVLEX2 ; 

Se are a Pe ee 
INT1 : MTRXHDR» ; 
DEVI 3 STSXHDR» ; 
; EIEXHDR, H 

H ; 

H H 

ae ene oe sh cea Ser eis ah eee 
INT 2 MTRXGST» H 
DEV1 + STSXOST» ; 
: EIFXOST H 

H ; 

: ; 

: H 

; H 

aaa eee feee ees eea sano t 
INT1 : STSX101 thru H 
DEV1 : S$TSX118 : 
; 

sr i a ts net se hw ae ee en ae ae a eam 
INT1 + MTRX101 thru H 
DEVI + MTRX105 H 
3 4 

: ] a 
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Dbject text file 
of modules which 
execute in monitor 
mod@e 

Object text Files 
of task services 
modules which run in 
job mode with 

ring attributes 
LiFs1l2F,13F and 
LFF respectively. 


oe 82 we a ee we ae Oe Oe we ew 


Ee SS A A A a SS ea ee en ech oe an sam fae SO Oe A EN A A A IS SS A eA RD Se 
Each recompitation of 
these utilities. 


Object text files 

of the Gbject Library 
Generators System 
Command Languages 

and Object Text 
ROtNet ears 

Object cant Files 

of user test 

programs added 

© the avec? 


these tests 
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Header files dhick 
name the monitors 
task services, and 
error interface 
segment files» 
produced by 


Each yearn 
system. 


Sores 
Qutboard genie Each Velink 
table files for system. 


monitors task 
servicesy and 
error interface 
produced by 
VELINK. 


A AAD ED ORT RY ENN: cD «EN CO A ED NTS AE END OD OED OUND LANE LED AD AED eee ED OD 


The task services 
segment files 
produced by 


Each Velink 
systeme 


VeLiNts 
The soni tor Each Velink 
segment fites system. 
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Each recompilation of a 
monitor mode module. 
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Each pocaworaeien of 
a task services 
module within these fibraries. 
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VELINKe : ; 


p os 66 6a we oe + we ew ee } oe ee He oe we ~ ee we oe oe om oe > oe we ee we He oe we ob 


INT] H 
DEV1 ; 
wae + 
INT1 ; 
DEV1 H 
H 
ee 
INT2Z/INT1 3 
DEV1 ; 
INT2/INT1 3 
DEVI 


oe ee we oe we we 


INT2/INTL : 
DEV1 


an ne ie a an ae a a a 


AL7OINT 


7 ee a ee eee ee 
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DEVI 
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DEVI 
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INT2/INT1 3 
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SD I A EE EE  -c  - tae e 


LGB<offset>K 
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NOSTEXT 


A OE ERS ES AS A A EP A A RN NN TE A 


AD A AND ED ED NS GN iD a a ee ee ee a see 


12> SEP le en ee a ee ee ee ee ee ee ee ee 


XIDSTsXIDSK» 
XIDSP »XIHLP>» 
XIRES 


TP<offset>Kk 


oe 8 we > Be oe ee hb Ae we Oe HH He He Be oe we - we we ew 


Ct ee eT ee ee! 


i tee 


] 


a 
4 
? 
5 
a 
4 
4 
a 
i 
4 
t 


3 
a 
a 
a 
a 
a 
5 
2 
3 


Each Velink of a 
Duel State system. 


The error inter- 
face segment 
files produced 
by VELINKs 

A170 NOs CPU 
Monitor module 
binaries. 


' 
( 
‘ 
{ 
' 
! 
t 
t 
i 
' 
{ 
( 
! 
| 
' 
| 
' 
' 
j 
4 
' 
j 
§ 
t 
' 
{ 
! 
' 
' 
i 
| 
' 


Each recompilation due to 
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ation of NOS/VE. 
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BUILD N HELPFUL HINTS 


This paper describes helpful hints on how to use build N of 
NOS/VE. It is intended to supplements rather than to replaces the 
standard NOS/VE documentation. If you have any qustions or 
suggestionss please see Tom McGee or Geoff Barrett. Appendix A 
fists background documents and how to obtain them. 


To obtain additional copies of this document white running on SN101 
at Arden Hillss please type: 


GETsNHINTS/UN=GSB 
SES.FORMAT NHINTS TXTFCORM 
Update History 
Nate Changes 
12/22/80 Revisions for NOS/VE Phase C 
2/12/81 Additional revisions for NOS/VE Phase C 
6/9781 Revisions for NOS/VE Build N 
6/19/81 Additional revisions for NOS/VE Build N 
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E1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


El.0 MAJOR CHARACTERISTICS OF THIS BUILD 


o The CYBIL/CI compiler has been modified to support the SIS 
conformance procedure calling sequences In conjunction with 
this changes the NOS/VE object text (V1.2) has been revised to 
support building PVAs with a negative byte offset. The result 
of this is that all NOS/VE object files and object libraries 
produced prior to build N are incompatible with the build N 
object code utilitiess toader and compilers. Thereforeys all 
users of CYBIL/CI and NOS/VE build N and build 0 must recompile 
their modules with the new compiler and reconvert the object 
files and rebuild their NOS/VE object Libraries. <All code 
generators should be upgraded to the new object text 
definitions. 


Any attempt to use the previous versions of the object text on 
build N will result in the appropriate processor issuing e 
diagnostic. 


NCTE: SES tools and the SCITOII and CITOII converters will 
continue to support the non CYBIL/CI V1.1 object 
texte 


o DO NOT assian the ftoader map file to the terminal in interactive 
jobs (i.ees File TOUTPUT® or t$0UTPUT*). This will cause a 
system crashe File names are assigned to the map file via 
SET_LPROGRAM_OPTICNS», EXECUTEs and PMPSEXECUTE (program 
description). 


o Permanent Files now work. NOS/VE permanent files are permanent 
only until a crash or deadstart. 


The files JEDN»s SYSLIB and CYBILIB that everyone kad to GET from 
the NOS should now be attached as NOS/VE permanent files as 
foilows? 


ATTACH .USERI.SYSLIB FAMILY=FAMILY1 
ATTACH .USERI.CYBILIB FAMILY=FAMILY1 
ATTACH .USERIT JED FAMILY=FAMILY1] ™ For editor " 


However users whe use the SETUPs CITGOII and COL commands (which 
we strongly recommend) should never have to attach these two 
filese If it is necessary to do sos be aware that the names 
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E1.0 MAJOR CHARACTERISTICS OF THIS BUILD | 
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FAMILY1,»s USER1 will be changing to SSYSTEMs SSYSTEM during build 
0. 


o A temporary procedure is available that will perform several 
functions that will be handfed by vatidation and permanent files 
in the R1 system. The procedure is named SETUP,» and should be 
called first thing after gaining access to NOS/VE in interactive 
jobs and immediately after the LOGIN command in batch jobs. 


o A parameter has been added to the AMPSOPEN request. See 
Program Interface Status —- File Management! for further 
information. 


o Issuing the LOGIN command will cause a permanent file catalog to 
be created for the current user/family. Do: 
LOGIN user=xx x 
Interactive jobs have family=*NVE and batch jobs have 
family=REMOTE. An example: 


LOGIN user=Z77 
DEFINE .ZZZ.A 


For an interactive job creates: 
oZZZ.A FAMILY=NVE 

For a batch job it creates: 
oZZZeA FAMILY =REMOTE 


Note that the current user name may be specified by the USER 
construct -- as in? 


ATTACH SUSER.A 
LOGIN should be the first command issued in a batch job}; 
followed by SETUP. For an interactive jobs the first NOS/VE 
command issued should be SETUP since interactive users login to 
the NCS NAM, 


o Job and standard filess as documented in the "Command Interface 
ERS» Rev.e8'» are available. 
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£1.20 MAJOR CHARACTERISTICS OF THIS BUILD 


ec For interactive jobs» files INPUT, OUTPUT and COMMAND are 
connected (assigned) to the terminal automatically for every 
task in a jobe The RMPSREQUEST_TERMINAL request must be used to 
assign files other than COMMAND, INPUT,» OUTPUT to a terminal 
devices 


o You can cause SCL to output the commands being executed from a 
procedure or include file by doing? 


connect _file ECHO S0OUTPUT 


ec The NCS/VE editor is availiable on (B56) file JEDN/unzIFP. The 
editor can be accessed by the EDIT nonstandard command. If you 
want more information about the editors contact Jack Bohnhoff. 


o The REWIND and RETURN commands are availabie. These commands 
accept NAME rather than FILE REFERENCE parameters; this should 
only present a problem in an SCL procedures Ail FMxxx commands 
(tike FMRETURN) have been removed: 


RETURN A 
RETURN (AyBosC) 


Files cannot be returned if they are open. 


o Files will be returned at job termination. Files will also be 
closed at task termination. 


o The procedure CLPSGET_LSTND_LINP has been deleted. Procedure 
CLPSPUT_STND_OUT will be deleted in Build GO or Pe Everyone 
should convert to use BAM, 


oc When sharing executable files via permanent files (compilerss 
librariess etc.) you should make the file an object tibrary 
(via the COL utility). By sharing object libraries (instead of 
object files) the code is actually shared among all tasks using 
the tibrary (the library is not copied to another segment but is 
executed directly). 


o The fite(s) specified by the FILE parameter on the EXECUTE 
command may not be object tibrary files. 


o The program option PRESET has no effect since the file system 
does not yet support presettings 
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El.0 MAJOR CHARACTERISTICS OF THIS BUILD 
El.1 NOS/VE USAGE EXAMPLES 


Elel NOS/VE_ USAGE EXAMPLES 


El.1.1 EXECUTING PROGRAMS 


LIMITATIONS 


- The file(s) specified by the FILE parameter on the EXECUTE 
command may not be object library files. 


- The program option PRESET has no effect since the file system 
does not yet support oresetting. 


- Jf you are an interactive users DO NOT cause the map to be 
written to the file OUTPUT’ or PS$OUTPUT® (SET PROGRAM OPTIONS 
or EXECUTE) - doing so will crash the system. 


PROCESS 


Create an object text file by compiling a program on NOS. Then 
perform the following steps on NOS/VE?: 


- Acauire any necessary tibraries (which are not quoted in text 
embedded directives) by either: 


o Attaching them from the system catalogs either explicitly or 
via prolog 
or 
o Creating the ltitrary file via the object tibrary generator 
or 
o Staging the tibrary file from NGS to NOS/VE using the 
GETLFILFE command (with B56 conversion mode specified). 


- Get the file from NOS and convert the object text fite from the 
CI data mapping to II data mapping by executing the CITCII 
commande 


- Load and execute the program via the EXECUTE commands specifying 
the necessary libraries with the LIBRARY parameter }3 
alternatively SET_LOBJECT_LIST may be used to include the 
libraries in ali subsequent EXECUTE commands. 


- Stage the icadmap from NOS/VE to NOS for printing by using 
either: 


o The REPLACE_LFILE command with A6 conversion mode specified 
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£1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
El.1.1 EXECUTING PROGRAMS 


if running on the simulator. 
or 
ec The PRINT command if running on the hardwaree 


EXAMPLES 


The fottlowing is an example command sequence for executing a 
program not requiring any libraries for loading? 


Assumptions: all modules to be foaded are contained on the NOS 
permanent file 'citxtrs', 


SETUP JLN JLNYX 

CITOIT CITXTrRS 

EXECUTE CITXTRS PARAMETER='*program parameters! 
PRINT LOADMAP 


The following is an example command sequence for executing a 
program requiring tibraries for ftoading: 


Assumptions: the NOS permanent file tcitxtrs!? contains object text 
generated by the CYBIL CI compiler. The compiler modules reference 
procedures contained on the user tibrary tmylib* and the CYBIL 
run-time library. These libraries have been generated on NOS/VE 
and saved on NOS. 


SETUP JLN JLNX 

GET_LFILE MYLIB CxB56 

SET_PROGRAM_OPTIONS MAP_OPTIONS=(BoEsX9S) 

CITOII CITXTRS 

EXECUTE CITXTRS "program parameters! LIBRARY=MYLIB 
PRINT LOADMAP 


Notes: 


o0 CLGO170 is NOS permanent file name for file containing CI object 
text for modules to be inciuded in the library. 


o IITEXT180 is NOS/VE tocal file name for file containing II 
object text for modules to be Included in the library. 


coc LIBRARY180 is NOS/VE tocal file name for the tlibrary being 
created, 
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E1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
El.1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 


0 


ILI817¢G is NOS permanent file name for file containing the 
librarye 


NOS/VE Job Commands 


SETUP JLN JLNX 
CITOII CLGO170 TITEXT180 


COL 


ADD LIBRARY=IITEXT180 

GENERATE LIBRARY=LIBRARY18O 

QUIT 

REPLACE_FILE LIBRARY180 ILIB170 C=B856 


F1.1.3 MODIFY A PREVIGUSLY SAVED OBJECT LIBRARY 


Notes 

ec ILIB17C is NOS permanent fiie name for file containg the old 
jibrary 

o LIBRARY180O is NOS/VE Iccal file name for file containing the old 
library 

o CMOD17C is NOS permanent file name for file containing CI object 
text for the new module 

o NEWIIMODULE is NOS/VE local file name for file containing II 
object text for the new module 

o NEWLIBRARY is NGS/VE local file name for the library being 
created 

o NLIB176 is NOS tecal file name for new tlibrary 


NOS/VE Job Commands 


SETUP JLN JLNX 
GETLFILE LIBRARY180 ILIB170 C=856 
CITOIT CMO0170 NEWIIMODULE 


COL 


ADD LIBRARY=LIBRARY180 

REPLACE FILE=NEWIIMCDULE 

GENERATE LIBRARY#*NEWLIBRARY 

QUIT 

REPLACE _FILE NEWLIBRARY NLIB170 C=B56 
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—E1l.0 MAJOR CHARACTERISTICS OF THIS BUILD 
E1.21.4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 


El.1.4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 


Running from an Interactive terminals enter: 


GET»filename,. 
ROUTEsfFfileneamesDC=LPsFCH=RH. 


The input file which is sent to NOS/VE must be in 64/12 ASCII (for 
display code subset). The job file must be a single partition NOS 
record containing NOS/VE commands. Multi partition input files are 
not supported hy NOS/VE so NOS data files used by the program must 
be obtained through the GET FILE command. 


£l.1l.5 PRINT A NOS/VE FILE 


At NOS/SVE job termination the job tog will be automatically 
returned to NOS. The job tog will be appended to the NOS/VE output 
File GUTPLT. NOS/VE print files must be written by BAM as 8/78 
ASCII RT#W. Print files will be converted from 8/8 ASCII RT=W to 
Display Code (64 character set - upper case only) when they are 
sent to NOS. Support for ASCII print files (8/12 ASCII) will be 
added at a fiater bullds All NOS/VE output files will appear in the 
NOS output queue (NOS Hs display) with the name IRHFxxx as a 
banner. In order to route a NOS/VE print file to NOS» the 
following command must be contained in the NOS/VE job file or be 
entered from the system console via the K display? 


JMROCUTEs jobnamesfilenamesPR»REMOTE 


jobname ~ name that the print file will have in the NOQS/VE 
output queue. 


filename - name of the local NOS/VE file created by BAM that 
is to be printed. 


PR = specifies that the file is a print file (must always be 
PR). 


REMOTE - name of the NOS/VE family for the print File (must 
always be REMOTE). 


Example of JMROUTE command? 


JMROUTE sLISTINGsLINKMAPsPR»sREMOTE » 
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—1.0 MAJGR CHARACTERISTICS GF THIS BUILD 
Elels5 PRINT A NOS/VE FILE 


The SCL PRINT command can also be used to print files. 
See the command ERS for details. 


On the NOS sides the printer must be physically and 
logically cone To logically turn the printer ons under DSD 
enter? 

CN32. 

FORM3259TM. 
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£2.20 COMMAND INTERFACE STATUS 


2.0 COMMAND INTERFACE STATUS 


E2e121 LOGIN TO NOS/VE 


To initially login to NOS/VE via TAFs you must cause the first 
login attempt to fail. This can be done by responding to the 
"FAMILY3" login prompt with something like? "AsAsA". This must be 
done because the system will try to connect the terminal to IAF on 
the first fogin attempt no matter what is typed. To access TAF do 
the following on the second "FAMILY?" prompt: 


suserspasswordsTAF 
You can access TAF from IAF by doing "HELLO»sTAF" or by answering 
TAF to the system prompt "APPLICATIGN:*®, 


E2ele2 TERMINAL USAGE 


1) The question mark (2) is the prompt to enter a NOS/VE 
command. Any normal NOS/VE command can now be entered. The 
full ASCII character sets» tower or upper case and all special 
characterss can be used. 


2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate. A new NOS/VE Interactive Job can then be started by 
responding to the "APPLICATION: * prompt with TAF. 

3) Terminal breaks (control-T and control-P) now work. It is 
possible to terminate a task or to suspend a task and enter a 
new task to process SCL commands. When a break is entereds the 
options available to the terminal user are: 

R =- resume from point of interruption 
T = terminate task} nebe commands running in the job monitor 
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E220 COMMAND INTERFACE STATUS 
E2ele2 TERMINAL USAGE 


task fer.g.e. COPYs EXECUTE etc.) cannot be ternrinated. 


S = process SCL commands. To resume execution at the point of 
interruption use the HCS command TMEXIT (temporary). 


E2ele3 NOS/VE PROGRAM ACCESS TQ THE TERMINAL 


1) Interactive NOS/VE jobs are abie to obtain terminal input 

. through the AMPEGET_NEXT or AMPSGET_ PARTIAL program interface 
which can be used by both task services and user ring 
programs. Interactive programs which use this interface should 
be able to handie both upper and flower case input in order to 
make them more convenient to use in both 64 and 96 character 
set modes. 


E2e2 COMMAND FUNCTIONS 


Eunction_ status 

MOD unchanged 
SCHAR unchanged 
£€CLocK unchanged 
$DATE unchanged 
SFENAME unchanged 
SINTEGER unchanged 
fNAME unchanged 
ORD unchanged 
REAL unchanged 
$STRING unchanged 
{STRLEN unchanged 
STRREP unchanged 
~$SUBSTR unchanged 
TIME unchanged 
$VAR unchanged 
SPECIFIED unchanged 
SET COUNT unchanged 
$VALUE_COUNT unchanged 
SRANGE unchanged 
$CEBUG  MODE_ON unchanged 
FPARAMETER_ LIST unchanged 
¢ PARAMETER unchanged 
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E220 COMMAND INTERFACE STATUS 
E20200-02021 System Access Commands 


E2e2e00e0e0sl System Access. Commands 


Commands_ siatus 
LINK_USER unchanged 
LOGIN new - ¥*1l 
LOGOUT new 


*1 A master catalog is created for the user who issues LOGIN 
command. Ne parameters are necessary, 


E203 RESCURCE MANAGEMENT 


Command Status 


REQUEST_TERMINAL not available 


E204 FILE MANAGEMENT 


Command. atatus 

FILE updated to Rev 8 ERS 
COPY unchanged 

DUMP_FILE unchanged 

COMPARE unchanged 


E25 PERMANENT _EILE_ MANAGEMENT 


Commend. Status 
HCS GET unchanged 
HCS REPLACE unchanged 
DEFINE unchanged 
ATTACH unchanged 
PURGE unchanged 
CHANGE unchanged 
PERMIT unchanged 
CDELETE_PERMIT unchanged 
DEFINE CATALOG unchanged 
PURGE_CATALOG unchanged 
DELETE_CATALOG_ PERMIT new 
PERMIT _CATALOG new 
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E220 COMMAND INTERFACE STATUS 
E2.5 PERMANENT FILE MANAGEMENT 


Ruild N Permanent File Program Interface Deficiencies 


1. 


20 


In order to access the NGS/VE permanent files of a users a 


master catalog must exist for that user. 
the validation facility will 
when the user is created. 
facility does not existe 


user being logged in. 


At release one times 


create a master catalog for a user 


At build Ns howevery the validation 
To circumvent this problems the LOGIN 
command has been modified to create a master catalog for the 


Thus» once a user has 


flogged in it will 


be possible to perform NOS/VE permanent file operations for 


that usere 
for ati jobs» 


Permanent files on NOS/VE are only permanent until 


deadstart. 


The WAIT parameter for ATTACH 
PFCSNO_WAIT is specified. 


E206 SCL_ STATEMENTS _AND_ PROCEDURES 


Command. 


PROC /PROCEND 

SET. COMMAND_LIST 
DISPLAY _COMMAND_LIST 
REPEAT/UNTIL 
WHILE/WHILEND 
DECLARE _VARIABLE 
REMOVE _ VARIABLE 
BLOCK/BLOCKEND 
LOOP /LOOPEND 
FOR/FOREND 
IF/ELSEITF/ELSE/IFEND 
CYCLE 

£XIT 

INCLUDE 
COLLECTLTEXT 
DISPLAY_VALUE 

EXIT PROC 

ACCEPT 

Da . 
CONNECTLFILE 
DISCONNECT_FILE 
DISPLAY_CONNECTION 


atatus 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


Since a LOGIN command will eventually be required 
it should be no hardship to inciude it in jobs 
starting with buiid N. 


a NOS/VE 


is always treated as if 


¥*1 


parameter changes 
added status parameter 


new 
new 
new 
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—€2.0 COMMAND INTERFACE STATUS 
EZ2e6@ SCL STATEMENTS AND PROCEDURES 


change HCS variable unchanged 
display HCS variable unchanged 


*1l Variables can no longer be deciared with the same names as the 
boolean constants. 


E2e7 INIERACTIVE COMMANDS 


Command. status 
RESUME new 
TERMINATE new 


£228 OBJECT CODE MAINTENANCE 


Command. atatus 

CREATE_OSJECT_LIBRARY unchanged 
DISPLAY_LIBRARY | unchanged 
SELECT_DISPLAY_LEVEL unchanged 
ADD unchanged 
REPLACE unchanged 
COMBINE unchanged 
CREATE_MODULE unchanged 
BIND MODULE unchanged 
DEFINE_PROGRAM unchanged 
DELETE unchanged 
CHANGE unchanged 
SATISFY unchanged 
REOQRCER unchanged 
GENERATE unchanged 
QUIT unchanged 
CI te II Conversion unchanged 


1) An II object file or library can be displayed using the 
nonstandard command GRJLIST. 
Example? 


OBJLIST IT_OBJECT LISTING 
Where TI_OBJECT is an II object file or object library and 


LISTING is the file containing the formatted object text 
listing. 
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£220 COMMAND INTERFACE STATUS 
E228 OBJECT CODE MAINTENANCE 


2) Users of CREATE_OBJECT_LIBRARY and OBJLIST must now get the 
Pproorams to NOS/VE via the following commands prior to their 
execution, 

ATTACH .USERI.SYSLIB FAMILY=FAMILY1 


ATTACH ,USERI.CYBILIB FAMILY=FAMILY1 
SETOL ADD=SYSLIB 


The default system prolog used by the SETUP command eliminates 
the necessity of issuing these commands. Using SETUP is the 
recommended apprcach. 

3) CREATE_LQBJECT_LISRARY expects V1.2 of the object text and V0.2 
object libraries. This is incompatible with previous releases, 


All NGS/VE object Files and object libraries must be 
regenerated. 


E209 USER SERVICES 


Commend. aiatus 
DISPLAY_LOG UPON changed to OQUTPUT ~- ¥*1 


*1 type = <system i! sys i job> instead of type = <system $ account 
{ engineering {| statistics | job | job -statistic> 


Warning - If you print display iog output on a fine printers you 
must use the PRINT <file name> SHIFT=#YES command or you will get 
one line per pages 


E2010 FILE-ROUTING 


Command. Status 
HCS JMROUTE unchanged 


F2e11 PROGRAM EXECUTION 


Command. atatus 
SET _GBJECT_LIST unchanged 
SET_PROGRAM_OPTIONS unchanged 
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E220 COMMAND INTERFACE STATUS 
E2011 PROGRAM EXECUTION 


DISPLAY PROGRAM unchanged 
EXECUTE unchanged - *2 
"name call" unchanged - ¥*1 
PUSH _DEBUG_MODE unchanged 

POP _DEBUG_ MODE unchanged 
SET_DEBUG_MODE unchanged 

SET _DEBUG_RING unchanged 
TERMINATE_ TASK new 


*1 Warning - “name cal!" works only for SCL procedures unless a 
FILE command has been issued to specify that the file is an 
object file and the structure is data» The FILE command must 
be reissued every time the File Is attached or brought over 
from NOS. 


*2 If you are an interactive users do not specify the values 


TCUTPUT' or 'SOUTPUT!® for the parameter MAP 3 doing so will 
crash the system. 


E2012 JO8 MANAGEMENT 


Copmang. atatus 

SUBMIT unchanged 
DISPLAY_JOB_LSTATUS unchanged 
DROP _ JOB unchanged 
PRINT unchanged 
DROP_FILE unchanged 
CISPLAY_PRINT_STATUS unchanged 


E2013 NOS/VE COMMANDS IMPLEMENTED _AS_PROCS 


In this builds several NOS/VE commands have been implemented as 
SCL procedures in order to make the system took more tike the final 
version. Users are urged to use these procedures rather than their 
interim counterparts since the interim commands will ultimately be 
withdrawn. 


In order to have these procedures available in your jobs you 
should use the SETUP command using the default system prologe. The 
precedures will be local files in your jobs so name conflicts 
should be avoided. 
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E2.213.1 GETLFILE 


This procedure is identical to the version documented in the 
NOS/VE ERS except that the defauit conversion is A6s We Intend to 
change the ERS to use this default as well. 


E2.13.2 REPLACE_FILE 


This procedure is identical to the version documented in the 
NGS/VE ERS except that the default conversion is AG We intend to 
change the ERS to use this default as well. 


£2.213.23 PRINT 


This procedure is similar toe the version documented in the 
NOS/VE ERS except that it returns the tiocal file after routing it 
to NOS. This is a deficiency of the JMROUTE command as well. 


In additions the PRINT command does not add carriage control to 
the file to be printeds if necessary. This can be done by using 
the SHIFT parameter of the command. 

The following is a description of the build N PRINT command: 
print File=list of <file> 

{shift=<boolean>] 

Cstatus=<status variable>] 

file: This parameter specifies a list of files to be printed. 
These files wili be returned after the files are routed 
to the printer. 


shift 3 s: This parameter specifies whether or not carriage 
control characters are to be added to the file. 


Omission will cause NO to be assumed, 


status: See ERROR HANDLING, 
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E2013.4 CREATE_OBJECT_LIBRARY } COL 


£22134 CREATE _OBJECT_LLIBRARY |: COL 


This procedure is identical to the version documented in the 
NOS/VE ERS except that only the command alias COL is available. 


E2014 NON_ STANDARD COMMANDS 


The following commands provide a nonstandard means of performing 
various fregquenttiy performed functions. They will be superceded in 
subseauent builds by standard commands and capabilities. 


E2141 SETUP 


The purpose of this command is to provide a "prolog” capability 
for ausere This Is an interim command and wiil be withdrawn when 
the full validation and permanent filte capabilities are available. 


Oniy a single SETUP command should be issued in a batch job or 
terminal session. Any SETUP commands issued after the first will 
fail due to the presence of the LINK_USER command. The SETUP 
command should be the First NOS/VE command issued in an interactive 
job and should be issued Immediately Following the LOGIN command in 
@ batch job. 


setup user#Cname>d 
password=<Cname> 
[prolog=<name>] 
Csystem_prolog=<name>] 
Cfamily=<named] 
{status=<status varlable>] 


user } ui This parameter specifies the name of the user 
responsible for the processing to be accomplished. 


Password : pwi This sarameter specifies the user password. 
The password together with the user and family name will 
be used to construct a tink user command. This iink user 
command will be processed as a part of the setup 
command. 


prolog : p? This parameter specifies the name of a NOS file 
which will be copied to the current session environment 
(get operation). This file will then be interpreted 
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using the include capabitity. Omission will cause a file 
mame of PROLOG to be used. 


system _prolog i spt This parameter specifies the name of a 
NOS/VE files within the USER] catalogs which will be 
attached to the current session environment (ATTACH 
operation). This file will then be Interpreted using the 
inciude capability. Omission wilt cause a file named 
SYSPROF te be used. The functions performed by SYSPROF 
can be determined by either doing a COPY SYSPROF or COPY 
NOTE command to see the contents at a terminal. 


family }; f: This parameter specifies the name of the family to 
be accessed. Omission will cause a family name of NVE to 
be used. 


status: See ERRGR HANDLING. 


£2e14.2 CITOLII 


The purpose of this command is to get a CI object file or object 
library from NGS and to convert it to an II object file suitabie 
for processing by the NOS/VE loader and/or object library 
gener atore 


citoii ci=<NOS file name>d 
Lif’=<NOS/VE lfn>] 
LTuser=<NOS user named] 
Cstatuse<status variable>] 


ci: This parameter specifies the NOS permanent file name of 
the CI object file or object library to be converted. 


ii: This parameter specifies the NOS/VE file name on which the 
converted (ieee. II) object file is to be written. 


Omission will cause the CI file name to be used, 


user: This parameter specifies the NOS user name in whose 
catalog the CI object file is located. 


Omission will cause the user name of the user issuing the 
command to be used, 


status: See ERROR HANDLING. 


Build N»s June 1981 


oo we 


oe 8a 2h BH Ge Oe Oe GO 


ae nt me 


oo 


ae 


Se 66 © we 


i ee oe oa oe 


ae woo 


E2-i1 


S2 Machine Usage Document 


07/29/81 


E220 COMMAND INTERFACE STATUS 
E2e14.3 OBJLIST 


E2014.3 CBJLIST 


The purpose of this command is to produce a formatted tisting of 
a NOS/VE object module produced on NOS/VE fiees II object text). 


objlist object=<lfn> 
Clist2z<ifnd] 
Cstatus=<status variable>] 


object i o: This parameter specifies the object file or object 
library to be iisted,. 


list } I: This parameter specifies the file on which the 
formatted listing Is to be written. 


Dmission will cause the Listing to be printed on the 
Jocal printer. 


status: See ERROR HANDLING. 
F2.14.4 LINK_USER ¢ LIV 


The LINK_USER command is the same as documented in the NOS/VE 
command interface with the exception that the alias LIU is 
supported in the current system and the CHARGE and PROJECT 
parameters are optional (and in fact not useful in the current 
environment since we disable that feature on the NOS side). 


F2214.25 GET 


This command is an interim imolementation of the final GET_LFILE 
command that is documented in the NOS/VE command interface. All 
users should use the GET_LFILE procedure now available as the GET 
command will be withdrawn in subsequent builds. 


The GET command obtains a copy of a permanent file residing on 
the 170. The 170 permanent file can be either a direct or an 
indirect access permanent file. All parameters on the GET command 
are positional. OQnity the 'tfn* parameter is required. A LINK_USER 
command must be issued (for the 170 family on which the permanent 
file resides) prior to issuing the GET ccmmand. The formet of the 
GET command is? 
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OO PE DOPE TO BOTA PD POLE PO PAPE OD PE IE PE PE PO OO TE PE PAPE PE PO PEPE POPE ODE TE PE PERO TE PATE PO TOE O PEO PO EE 20 8 88 PE OO PO TE OE PE EPO te 0 8 ee 


GETsIifnascfnsewsuns fmacd. 


ifn (local file name) - This is the name of the ftocal NOS/VE 
file te which the 176 permanent file will be transferred. 


pfn (permanent file name) - This is the name of the 170 
permanent file that is to be accessed.» If this parameter is 
omitted then ifn? will be used for the 170 permanent file 
namee 


pw (password) ~ This is the password that will be used to 
access the 170 permanent file if a password is required to 
access the file on the 170. 


un (user name) — This is the user name (atternate catalog) on 
which the 170 permanent file resides. 


fm (family) - This is the family on which the 170 permanent 
file resides. Currentiy the only 170 family on the S2 Dual 
State system is NVE. 


ca {conversion alternatives) - This parameter specifies the 
type of conversion that is performed by the IRHF on files 
transferred from 170 to 180. If this parameter is omitted 
then a default of B60 will be assumed. Vaiues for this 
parameter are? 


BéC: Basic Binary 


The full 60 bits of each 170 word are transferred to the 
lower 60 bits of each 64 bit 180 word. The upper 4 bits 
of each 64 bit 180 word are set to 0. The file is written 
to 180 using BAM with Block Type = System and Record Type 
= Undefined (RT=U) so no control information is inserted 
in the file. The 170 logical record structure is dropped 
(ie@s.» EQRs are deleted causing the logical records to be 
packed together. 


B56: C180 Binary 


The tower 56 bits (7 8 bit bytes) of each 170 word are 
packed into contiguous 8 bit bytes on the 180 (i-eees 7 8 
bit bytes from the first 170 word and 1 8 bit byte from 
the second 170 word go into the first 180 word etce). The 
170 logical record structure (EDRs) are dropped. The way 
that the 180 file which was transferred from 170 is 
accessed should correspond to the method used to create it 
on the 180 orisginaltly (assuming that the file originated 
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on the 180). 
A6: 6/12 ASCII 


A170 6/12 ASCII character files (used by XEDIT and most 
SES utilities) are converted to 180 8/8 ASCII with Block 
Type = System) and Record Type = Variable (RT#W). The 170 
logical record structure EOQRs are dropped. 


AB: B/12 ASCII 


170 8/12 ASCII character files are converted to 180 8/78 
ASCII with 8lock Type = System and Record Type = Variabie 
(RT=W). The 170 logicai record structure (EQRs) are 
dropped, 


D644: Display Code 64 Character Set 


170 Display Code character files are converted to upper 
case 180 8/8 ASCII with Block Type = System and Record 
Type = Variabie (RT=W). The 170 logical record structure 
FORsS are dropped, . 


Example of GET command: 


LIUsUS=(FABsNVE) »PA=FABX »A=71369 PR=73E08802. 
GETsTEXTsTEXT612 saa NVEs Abe 


Note: When the GET command is used on the Simulators the 
file specified by the 'pfn! parameter must be a 170 
file which is ltocal to the simulator job. 


F2014e6 REPLACE 


This command is an interim imptementation of the final 
REPLACE_FILE command that is documented in the NOS/VE command 
interface. All users should use the REPLACE_FILE procedure now 
availabie as the REPLACE command wil! be withdrawn in subsequent 
builds. 


The REPLACE command transfers a copy of a 180 local file to a 
permanent file on the 170. If a permanent file of the same name 
does not exist for the specified user (catalog)»s a direct acccess 
permanent file is created. If a direct access permanent file of 
the same name already exists in the catalog and the file can be 
attached with write mode then the existing direct access file is 
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overwritten with the file From the 180. If an indirect access 
permanent file of the same name already exists in the catalog then 
the indirect access file is replaced by the file from the 18C. An 
existing indirect access file will not be changed to a direct 
access file if the user's indirect access file size Limit is 
exceedede REPLACE command. All parameters All parameters on the 
REPLACE command are positional. Oniy the 'tfn' parameter is 
required. A LINK_USER command must be issued (for the 170 family 
on which the permanent file resides) prior to issuing the REPLACE 
command. The format of the REPLACE command is: 


REPLACEs i fnspfinspwesunsfmscaes 


lfn (local file name) - This is the name of the focal NOS/VE 
File which will be transferred to a permanent file on the 
170. 


pfn (permanent file name) - This is the name of the 170 
permanent file that is to be created or replaced. If this 
parameter is omitted then "ifn' wit! be used for the 170 
permanent file name. 


pw (password) - This is the password that will be associated 
with a newly created direct access file or which is used 
to gain access to an already existing direct or indirect 
access permanent file. 


un (user name) - This is the user name (catatog) on which an 
existing 170 direct or indirect access file resides. This 
parameter is iltegal if the file does not existe 


fm (family) - This is the family on which the 170 permanent 
file is to reside. Currentiy the only 170 family on the 
$2 Dual State system is NVE. 


ca {convertion alternatives) -— This parameter specifies the 
type of conversion that is performed by the IRHF on files 
transferred from 180 to 170. If this parameter is omitted 
then a default of B60 will be assumed. Values for this 
parameter are? 


B60? Basic Binary 


The lower 60 bits of each 64 bit 180 word are transferred 
to the full 60 bits of each 170 word. The upper 4 bits of 
each 64 bit 180 word are discarded. The 180 file which is 
to be transferred should be written by BAM with Block Type 
= System and Record Type = Undefind (RT#U). The file is 
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transferred to the 170 as a singie logical record (i.e. 
files with multiple EGRs cannot be created on the 170 from 
the 180). 


R562 C180 Binary 


A63 


ABS 


D643 


Groues of 7 contiguous 8 bit bytes from the 180 will be 
transferred to the tower 56 bits of each 176 word (ieee 
the first 7 8 bit bytes from the first 180 word go to the 


jower 56 bits of the first 170 words the 8th 8 bit byte of. 


the first 180 word and the first 6 8 bit bytes from the 
second 180 word ge to the lower 56 bits of the second 170 
word etc»). The way that the 180 file to be transferred 
is created does not matter because the entire structure of 
the 180 file is preserved on the 170. The file is 
transferred to the 170 as a singie logical record. 


6/12 ASCII 


A 180 878 ASCII character file with Block Type = System 
and Record Tyee = Variable (RT#W) is converted to a 170 
6/12 ASCII file (used by XEDIT and most SES utilities). 
The file is transferred to the 170 as a singte logical 
record. 


6/12 ASCII 


A 180 8/8 ASCII character file with Block Type = System 
and Record Type = Variable (RT=W) is converted to a 170 
8/12 ASCII file. The 170 file can be routed directty to 
the printer with the 170 ROUTE command with the EC#A9 
parameter. The file is transferred to the 170 as a single 
fogicai record. 


Display Code 64 Character Set 


A 180 878 ASCII character file with Block Type = System 
and Record Type = Variable (RT=W) is converted to a 170 
Display Code file with lower case characters mapped to 
upper casee ASCII special cheracters that do not have a 
Display Code equivalent are converted to Display Code 
tlanks. The file is transferred to the 170 as a single 
logical record. 


Example of REPLACE command? 


LIUsUS=(FABsNVE) sPAZFABX 9 A271369PR273E08802, 
REPLACE sMYFILEsFILEB565 5 59NVE 9B56. 


Build Ns» June 1981 


E2-16 
$2 Machine Usage Document 
07/29/81 


E220 COMMAND INTERFACE STATUS 
E2214.6 REPLACE 


Note? When the REPLACE command is used on the Simulators the 
file specified by the tpfn' parameter will become a 170 
File which is local to the simulator job. 
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£3.20 PROGRAM_INTERFACE STATUS 


The *#status*? column indicates whether the procedure is unchanged 
from the previous builds modified from the previous build or not 
available in this build. Footnotes are numbered within each 
section. 


E3.1 _COMMAND. PROCESSING 


a 


ee 2G SH we 


OSPEAPPEND_STATUS_INTEGER 


Procedure. aiatus 
CLPSSCAN_PARAM_LIST unchanged 
CLPSTEST_ PARAMETER unchanged 
CLPEGET_KEYWORD unchanged 
CLPSGETLSET_ COUNT unchanged 
CLPS$GET_VALUE_C CUNT unchanged 
CLPSTEST_RANGE unchanged 
CLPSGETUVALUE unchanged 
CLPSDECLARE_ VARIABLE unchanged 
CLPSREMOVE_VARIARLE unchanged 
CLPSREAD_VARTABLE unchanged 
CLPEWRITE_ VARIABLE unchanged 
CLPSSCAN_COMMAND_FILE unchanged 
CLPSEND SCAN_COMMAND_ FILE unchanged 
CLPSSCAN_COMMAND_LINE unchanged 
CLPEZPUSH/POP COMMAND LIST unchanged 
CLPSCREATE_FILE_ CONNECTION new 
CLPSDELETE_FILE_CONNECTION new 
E3e2 MESSAGE CENERATOR 

Procedure. atatus 
OSPSEFORMAT_ MESSAGE unchanged 
OSPSSET_STATUS_ ABNORMAL unchanged 
OSPSAPPEND_ STATUS_PARAMETER unchanged 


unchanged 
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£303 RESOURCE MANAGEMENT 


Procedure. 


RMPSREQUEST_MASS_STORAGE 
RMPSREQUESTUTERMINAL 


Status 


unchanged 
unchanged 


All terminal attributes can be specified on the 
RMPSREQUEST_TERMINAL call but only the following are 


operational: 


auto_input 
transparent_mode 
prompt_file 
prompt_string 


oo oO6 


Files assigned to a terminal device can be accessed via the 


foliowing BAM requests? 


AMPSOPEN 
AMPSGET_NEXT 
AMP$GET_DIRECT 
AMPEGET_PARTIAL 
AMPSPUT_NEXT 
AMPSPUT_DIRECT 
AMPSPUT_PARTIAL 
AMPSCLOSE 


oo0o0o0 000 


E3+4 PROGRAM EXECUTION 


Procedgure_ 


PMPSEXIT 

PMPSEXECUTE 

PMPSTERMINATE 
PMPSAWAIT_TASK_ TERMINATION 
PMPS$MODULE_TABLE_ADDRESS 
PMPSENTRY_POINT_TABLE_ADDRESS 
PMP$PUSH_JOB_DE BUG_MODE 
PMP$POP_JOB_DEBUG_MODE 
PMPSSET_JOB_DEBUG_MODE 
PMP$JOB_DEBUG_MODE_ON 
PMPSPUSH_TASK_DEBUG_MODE 
PMPSSET_TASK_DEBUG_MODE 
PMPSTASK_DEBUG_MODE_ON 


Status 


unchanged 
unchanged - *1 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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PMPSSETLDEBUG_RING 


PMP&DEBUG_RING unchanged 
PMPSCHANGE DEBUG_LIBRARY_LIST unchanged 
PMPSPOP_TASK_DEBUG_ MODE unchanged 

*1 DO NOT specify the values '40UTPUT? or *OUTPUT*® for the fieid 


LOAD _MAP_LFILE of the program description - doing so will crash 


the system. 


E3e5 PROGRAM COMMUNICATION 


unchanged 


Procedure. atatus 

OSPSAWAIT_ACTIVITY_COMPLETION unchanged 
PMPSCEFINE QUEUE unchanged 
PMPEREMOVE_QUEUE unchanged 
PMPSCONNECT_QUELE unchanged 
PMPSDISCONNECT_QUEUE unchanged 
PMPSSEND_TO_QUEUE unchanged 
PMPSRECEIVE_FROM_QUEUE unchanged 
PMPSSTATUS_QUEUE unchanged 
PMPSSTATUS_ QUEUES _ DEFINED unchanged 
PMPSGET_QUEUVE_LIMITS unchanged 


E3.6 CONDITION. PROCESSING 


Procedure. Status 
PMPSESTABLISH_ CONDITION _ HANDLER unchanged 
PMPSDISESTABLISH_COND_HANDLER unchanged 
PMPSCAUSE_CONDITICN unchanged 
PMPSCONTINUE_TG_CAUSE unchanged 
PMPSTEST_ CONDITION _ HANDLER unchanged 
PMPSVALIDATE_PREVIOUS_SAVE_AREA unchanged 
PMPZESTABLISH_DEBUG_CFF unchanged 
OSPSSET_STATUS_FROM_CONDITION new 
E3.7 _PROGRAM_ SERVICES 

Procedure_ atatus 
PMPSGET_TIME unchanged 
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PMPSGET_MICROSECOND_CLOCK 


unchanged 


PMPSGET_LTASK_CP_TIME unchanged 
PMPSGET_DATE unchanged 
PMPSGET_USER_IDENTIFICATON unchanged 
PMPSGET_ACCOUNT_PROJECT unchanged 
PMPEGET_JOBLNAMES unchanged 
PMPSGET_JOB_ID unchanged 
PMPZGET_JOB_MODE unchanged 
PMPSGET PROGRAM unchanged 
PMPSGETLUTASK_ID unchanged 
PMPSMANAGE SENSE_SWITCHES unchanged 
PMPSGET_OS_VERSION unchanged 
PMPSGET_ PROCESS OR_ATTRIBUTES unchanged 
PMPSDEFINE_DEBUG_ENTRY unchanged 
PMPSGET_DEBUG_ENTRY unchanged 
PMPSMODIFY_DEBUG_ENTRY unchanged 
PMPSREMOVE_DEBUG_ENTRY unchanged 
F328 LOGGING 
Procedure atatus 
PMPSLOG unchanged 
PMPSLOG_LASCII unchanged 
£369 FILE MANAGEMENT 

Procedure. atatus 
Sequential Access ¥*1 

Byte Addressable Access unchanged 
Record Access *1 
Segment Access unchanged 


W System Specified 
WUser Specified 
U_System Specified 
ULUser Specified 


unchanged 
new 
unchanged 
new 


FUSystem Specified unchanged 
F_User Specified new 

AMPSDESCRIBE_NEW_FILE unchanged 
AMPSFILE unchanged 
AMPSGET_LFILE ATTRIBUTES unchanged 


AMPSFETCH 


unchanged 
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—3.9 


FILE MANAGEMENT 


*] 


*2 


3 


#4 


*6 


AMPSSTDRE unchanged 
AMPSCOPY_FILE new 
AMPSRENAME new 
AMPSRETURN_LOCAL_FILE new 
AMPSCPEN unchanged added parameter 
AMPSCLOSE unchanged 
AMPS&FETCH_ACCESS_ INFORMATION unchanged 
AMPSSKIP *4 
AMPSREWIND *2 
AMPSWRITE_LEND_PARTITION new 
AMPEGET_NEXT *1,5 ¥*5 
AMPSGET_ DIRECT unchanged 
AMPSGET_PARTIAL *1l,» *6 
AMPSGET_PARTIAL_DIRECT unchanged 
AMPSPUT_NEXT *) 
AMPSPUT_DIRECT unchanged 
AMPSPUT_PARTIAL *¥l»y ¥*3 
AMPSPUT_PARTIAL_DIRECT unchanged 
AMPSSEEK_DIRECT unchanged 
AMPSGET_SEGMENT_POINTER unchanged 
AMPSSET_LSEGMENT_EDOI unchanged 


AMPS$SET_SEGMENT_POSITION 
AMPSSET_LOCAL NAME ABNORMAL 


unchanged 
new 


AMPESETLFILE_LINSTANCE_ABNORMAL new 
AMPSACCESS_ METHOD new 
AMPSFETCH_FAP_POINTER new 
AMPSSTGRE_LFAP_POINTER unchanged 


user specified blocking is now supported 


AMPSREWIND 


The WAIT parameter on the procedure call 


AMPSPUT_PARTIAL 


PUT_ PARTIAL with the TERM_OPTION = AMCESTART does pot start a 


new record. 


AMPESKIP 


is not supported. 


If the number of units to skip #®= © and the file is positioned 
mid-unit the file will remain positioned mid-unit. 


AMPSCET_LNEXT 

A GET_LNEXT with a working storage ftength = 0 will return an 
undefined file position. <A request of zero tength is invalid 
and will result in abnormal termination in later builds. 


AMPEGET_ PARTIAL 
A GET_LPARTIAL of record type = undefined never returns file 
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E329 


FILE MANAGEMENT 


position of end-of-record. 


E3010 PERMANENT EILE_MANACEMENT 


Procecure_ Status 

PFPSDEFINE parameter changes 
PFPSATTACH parameter changes 
PFPSPURGE Parameter changes 
PFPSCHANGE parameter changes 
PFPSPERBMIT parameter changes 
PFPSDELETE_LPERMIT parameter changes 
PFPSDEFINE_ CATALOG parameter changes 
PFPEZPURGE_CATALOSG parameter changes 
PFPSPERMIT_CATALOG parameter changes 
PFPSDELETE_CATALOG_ PERMIT parameter changes 


Bulld N Permanent File Program Interface Deficiencies 


1. 


3 


In order to access the NOS/VE permanent files cf a users a 
master catalog must exist for that usere At release one times 
the validation facility will create a master catalog for a user 
when the user is created. At build Ns however, the validation 
facility does not exist. To circumvent this problems the LOGIN 
command has been modified to create a master catalog for the 
user being fogged ins Thus» once a user has flogged in it wilt 
be possible to perform NOS/VE permanent file operations for 
that user. Since a LOGIN command will eventually be required 
for ali jobss it should be no hardship to include it in jobs 
starting with build N. 


Permanent files on the NOS/VE are only permanent until a 
NCS/VE deadstart. 


The WAIT parameter for ATTACH is always treated as if 
PFCENG_WAIT is specified. 


E3.11 _MEMORY MANAGEMENT 


MMPSADVISE_IN unchanged 
MMPSADVISE_OUT unchanged 
MMPSADVISE_OUT_IN unchanged 
MMP3WRITE_MODIFIED_PAGES unchanged 
MMPECREATE_ SEGMENT unchanged 
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MMPSDELETE_SEGMENT unchanged 
MMPESTORE_SEGMENT_ATTRIBUTES unchanged 
MMPS FETCH SEGMENT_LATTRIBUTES unchanged 
MMPS VERTFY_ACCESS unchanged 
MMPSFREE unchanged 
MMPSLOCK_ PAGES unchanged 
MMPSUNLOCK_ PAGES unchanged 
MMPSFETCH _PVA_LUNWRITTEN_PAGES unchanged 


E312 STATI TICS_EACILITY 


SFPSESTABLISHLUSTATISTIC new 
SFPSENABLFE_STATISTIC new 
SFPSDISABLE_STATISTIC new 
SFPSDISESTABLISH_USTATISTIC new 
SFPSEMIT_ STATISTIC new 
SFPSEMIT_SYSTEM_STATISTIC new 


£3.13 NOS/VE_EXCEPTIONS 


The following summarizes the exception code ranges currently 
assigned to NOS/VE. These code ranges represent a finer breakdown 
than the one specified in the SIS for internal NOS/VE development 
purposese Howevers it is important to remember that only the 
product identifiers documented in the SIS may appear in error 
MESSAGES « 


Common Modules 99000 - 99999 
Common Code Generator 89000 - 89999 
Product 
Exception Code Identifier Product Name 
1 - 15839999 Reserved 
1599000 - 159999S SY System Core 
1609000 - 16939999 AM Basic Access Methods 
160,009 — 1639999 BA Basic Access 
1649000 - 1645999 LN Local Name Mgr 
165000 — 1659999 JF Job File Mgr 
1669000 - 16639999 SR Conversion Services 
167,000 - 167999 CM Configuration Mgmt 
1709000 —- 17939999 CL Command Language 
18Cs000 - 1893999 JM Job Management 
190,000 - 1993999 LL Loader 
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E3.13 NOS/VE EXCEPTIONS © 


2009000 — 2092999 MM Memory Management 
2009000 - 20439999 MM Monitor Level 
2053000 - 2053999 MM Task Level 
2109000 = 2199999 os Qperating System 
2102000 =~ 21039999 os O$ 
211,000 - 2115999 MT EXEC 
2Z122CO0 2129999 TQ MS I/O 
213,»CC0 21339999 Ig Tape I/0 
2142600 2149999 DM Device Management 
2153000 2153999 ML Memory Link 
2169000 2169999 IF Interactive 
2173600 2173999 ™™ ™ Monitor 
218,000 2183999 ™ ™ Task 
219000 21939999 JS Job Swappers 
2209000 —- 22939999 PF Permanent File Management 
22129000 —- 2213999 ST Set Management 
2229000 —- 2229999 PY Permanent File Utilities 
2302000 —- 2395999 PM Program Management 
2409000 =—- 2499999 RM Resource Management 
25C, 000 2599995 CF Operator Facility 
2609000 26939999 AV User Administrator 
2709000 2799999 Ic Interstate Communication 
2809000 2899999 RH Remote Host Facility 
2903000 2999999 Gc Cbhject Code Utilities 
30020006 30959999 DB. Deadstart/Recovery 
310,000 — 3199999 MS Maintenance Services 
3202000 — 3299999 Reserved 
34C» 000 3493999 SF Statistics Face 
330,000 3393999 US User Errors 
500,000 50939999 AA Advanced Access Method 
510,0C0 —- 5199999 AG ALGOL 
520000 52939999 AL Assembly Language 
5309000 5399999 AP APL 
540,000 5499999 BA BASIC 
550,000 559%999 CA Conversion Aids System 
560s0C0 56939999 CB COBOL 
570,000 5799999 CY CYBIL 
58C0s0CO0 5899999 FT FORTRAN 
5965000 59939999 PA PASCAL (Wirth) 
60029000 6099999 Pl PL/1 
616,000 6199999 S™ Sort Merge 
620,s00C 6293999 Sc Source Code Utility 
6403000 6495999 OB Debug 
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E420 DUAL STATE DEADSTART AND CPERATION 


F400 DUAL STATE DEADSTART_AND_ OPERATION 


E4e1l ALZO_NOS DEADSTART 


o The system is configured to run with three FMD units (41,» 42 and 


43). 


o Set the D/S panel to deadstart from the primary system disk. 
This is Unit 43 for all Build N systems, 


Push 075 


ooo 0 0 8 


button 


Select "GQ" display 
Select *"H" display 
Enter CM=10000 
Enter (CR) 

Enter date/time 


Wait for deadstart to complete. 
Note: The deadstart tape DUALON (which is currentiy installed on 


unit 43) is 


found in the area in the northeast corner of the room 


where the tape cabinet is found. 


E4.2 CURRENT DUAL STATE CONFIGURATION 


o FMD Unit 


43 


This unit contains the following: 


- A170 NOS (Build 6 level)s CTI» CMSEs EI binaries» NOS 
deaedstart files 


- Files 
- Files 
~- Files 


o FMD Unit 


associated with user number LIBRARY 
associated with user number SES 
associated with DEV1l»s DEV2,s RELI,» INTl. 


41 


This is a scratch unit 


o FMD Unit 


42 
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E4.0 DUAL STATE DEADSTART AND OPERATION 
E422 CURRENT DUAL STATE CONFIGURATION 


This unit contains the following: 


- NOS/VE Development Area PL!s and Member PL'*s 

~ NOS/VE Deadstart Files to be tested (saved in individual 
userts catalogs) 

- Files associated with user number INT2 


E4.3 QUAL STATEs NOS_OPERATION 


1) 


2) 


The convention used for creating user numbers on NOS/VE is as 
follows? 


o Your user number will be your initials. 

o Your password will be these 3 fetters followed by the fetter 
yt, 

o You must see COMSOURCE (RK. Cooper - x3092) to be assigned 
a user index 


PF dumping and !toading 


You may use "SES.DUMPPF®” on SN/101 to dump your permanent fies 
to tapes and then foad them onto your user number on A170 NOS 
using "SES.»LOADPF". Documentation on how to use these SES 
procedure and what their parameters are is included in the SES 
"User's Guides or they can be obtained by typing: 


"SES »HELP.DUMPPEF™ and "SES sHELP.»~LOADPF®™, 


E4.4 NOSZVE_DEADSTART 


The following file must be availabie in your catalog on the 3823 


TPXXXK contains a NOS/VE deadstart image. This must te @ copy 
of the dual state deadstart images available from the tink 
procedures. 


CMIMAGEs PPIMAGEs RGIMAGE are "fast” Filess which are built from 
TPXXXK the first time you deadstart NOS/VE. These files are 
then used on subsequent deadstart attempts. Before a new TPXXXK 
can be useds these "fast" files must be purged off your user 
number. 


For Build Ns Mount the disk tlabeted "DAHL-Large sector™ on 844 
unit © (other disks will not work). The HCS disk driver (for 


Build N» June 1981 


ae ae 


ae eG 


E4-3 
$2 Machine Usace Document 
07/29/81 


E4.0 DUAL STATE DEADSTART AND OPERATION 
E404 NOS/VE DEADSTART 


smaii sector 844'!s5) will not work in Build N. 


o For Builds O greater than 05% Mount one of the disks labeled "S2 
S/N 104 system scratch” on 844 unit 1. This cannot be a large 
sector disk! For Builds n > 23 and Q0 > 5 the remote 
host/interactive 170 binaries must be sysedited into the running 
system until the deadstart tape has been updated: 


X.DIS. 

USER» SCATsSCATX. 

where "“scat™ = DEV1 for Build N 
"scat" = INT1 for build 0 
CALLsSYEDNVE. 


o Bring up dual state: 
X»UPMYVE (CAT=mycats DEVI=scat) 
where mycat = user catalog (as before) 
scat = system ctalog - INT2,» INT1 or DEV2 


o The UPMYVE job will display the following: 
RFQUEST *K* DISPLAY on the B display 


Type Ksne where nis the control point number of the UPMYVE 
job. 


NOS/VE is currently generated and initialized on both NGS and 
NOS/VE. All source and object libraries that make up the NOS/VE 
system are produced on NOS and therefore must be converted from 
their CI to II counterparts. Other parts of installing and 
initlalizing the system (e.g. building the SYSTEM catalogue) are 
performed by command fangquage procedures on NOS/VE. Since the same 
system will be deadstar many times in a closed shop environments it 
is advantageous to only perform the conversion from CI to II a 
single times save the results in the NOS file system and then 
simply bring the Files back during deadstart. 


The actual files that get installed and loaded on each deadstart 
are determined by a command tanguage procedure (the system profiie) 
interpreted on NOS/VE. This procedure can be modified by each site 
to initialize their NOS/VE environment in the most suitable 
fashion. The process of building the system profile an of 
performing the CI te II conversions is referred to as an 
installation deadstart and the process of executing the system 
profile and of fetching previously converted files from NOS and 
making them available in the NOS/VE file system is referred to as a 
deadstart. <A single command is availtable to perform both an 
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E4.0 DUAL STATE DEADSTART AND DPERATIGON 
E4e4 NOS/VE DEADSTART 


installation deadstart and a deadstart. 
F4.4.1 DS 


The purpose of this command is to perform an installation 
deadstart or a deadstart of NOS/VE. 


ds Cinstall=<boolean>] 
Cload_ source _Jibraries=<boolean>] 
Cload_products=<booleand] 
(status=<status variablie>] 


instal! : i: This parameter specifies whether an installation 
deadstart is to be performed. Valid specifications are: 
TRUE - installation deadstart to be performed 
FALSE = deadstart to be performed 


Omission will cause a deadstart to be performed. 


foad_source_libraries : Isit This parameter specifies whether 
SCU tibraries are to be loaded. Valid specifications 
are: 
TRUE - ftibraries are toaded 
FALSE ~- tHibraries are not loaded 


On the Arden Hills closed shop S2 systems the SCU 
libraries to be loaded are: 

OSLPI ~ operating system program interface 

Subset of NOSVEPL - operating system source library 


Omission will cause SCU libraries to be toaded,. 


foad_products $ ip: This parameter specifies whether the 
object Jtibraries defining the current product set are to 
be foaded. Valid specifications are: 
TRUE ~- the products are toaded 
FALSE ~- the products are not loaded 


Qn the Arden Hitts closed shop S2 systems the product set 
to be loaded consists of: 
CYBIL 
SCcuU 
Omission will cause the product set to be loaded. 
status: See ERROR HANDLING in the NOS/VE ERS. 
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E420 DUAL STATE DEADSTART AND GPERATION 
E424.1 03 


If you change any of the following decks you MUST use the 
installation deadstart from your own catalog (with files CYBILGO>s 
XLJOStL»s and XLJLIB): 


AMMTSA BAMDVR BAMPC4 BAMPC2 BAMPC1 BAMPC3 IIMRSE TIMRLE 
ITFMEXEC TIMA72H JIMTGEL FTIMRUSM TIMDC2S OCMRED OCMMUR OCMBIM 
OCMSDL OCMEND OCMLP OCMCPY OC MCRM OCMGEN GCMMCMS OCMDEF 
DCMOLG OCMCOL OCMOBJ QCMCHA OCHOFH OCMADD OCMNP GOCMDEL 
OCMCOM OCMSAT RHMQAF RHMQTIP RHMSFM RHMLOF RHMMLI 
 RHMQTE RHMLCF RHMLOG RHMQRE RHMAL2 RHM12ZA 
RHMWLF RHMRTN RHMGOM USORT UUSERI UUTL ; 


E4e422 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 


aan 


Type 

Keone where n is the UPMYVE control point number. 
KeLlIU (your unsyNVE) your password. 

KGET sDSsDSaaSCATsNVEs AG. 

K.0S TRUE FALSE FALSE. 


ee ee OH Oe ee 


eau 


The system is up when the following message comes up: 


SYSTEM IS NOW ALL UP AND RUNNING 
WAITING FOR MORE INPUT 


E424.3 EXAMPLE OF NOS/VE DEADSTART 


oe 


The Integration system has had the installation deadstart run on 
ite Also the files produced by the installation deadstart have 

been made semi-private and are found on the catalog used in the 

UPMYVE call. 


eae bh BO be 


Type (where DEV1 is the same as the CAT=zvalue in the UPMYVE 
call): 

Keane where n is the UPMYVE contro! point number. 

K.LIU (DEVI»sNVE) DEVIX. 

KeGETsDSaDSasaNVEoA6e 

K.»DS.» 


oe 4 we O64 BH USC 


The system is up when the following message comes up? 
SYSTEM IS NOW ALL UP AND RUNNING 
WAITING FOR MORE INPUT 


oe oa oo 
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E4.0 DUAL STATE DEADSTART AND OPERATION 
E4.5 NOS/VE TERMINATION 


E45 NOS/VE_ TERMINATION 


o Bringing down dual state: 
K.a*BYEVE. 

o If not a normal termination 
Ks *RUN. 


K.*ENDLST. 
K.*ENDRUN, 


E4e6 DSOT_INEQRMATLION 


To create an Express Deadstart Dump (EDD) tape? 
1) Mount scratch tape (ring in) on a G-track drive. 
2) Push D/S button. 
3) Setect U (utilities) display. 
4) Sefect E— (EDD) display. 
5) Set channel (S213). 
6) Set ECULU (S$2=01luu) 
FE = equipment 


C = 1 for 67X drives 
2 for 66% drives 


uu = unit number of the tape drive to be used. 
7) Answer “non zero inhibits rewind” with a CR. 
8) Answer “dump number" with a CR. 
9) Answer "dump controlware”™ with a CR. 


* - Warning if this step is omitteds OSDI canot process 
the dump tape. 


To create a listing of the EDD tape: 
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E4.0 DUAL STATE DEADSTART AND OPERATION 
E426 DSDI INFORMATION 


1) 
2) 


3) 


4) 


5) 


6) 


7) 


REQUESTsDUMPsNTsD=PE sFa=SaLlB=KU»PO=ReVSN=your choices 
GET»,OSOIZUN=DEV1. (On SIN 101.) 

or 
GETsDSDISUN=DEV1. (On $2.) 
Create DSDI directives files 
A DSDI directive file should include the following: 
IGUMR. 
PROMR. 
MEMMR, 
PRORF, 
Wsfirst byte_addressslast_byte_adresssaside (where the 
first _byte_eddress and last _byte_address are hex byte 
addresses and asid is the asid of the segment to be 
dumped) 
Execute BSOI2 


RFL»60C000. 
DSDIoaMsDesT="input directives file", 


To run (after the first time): 

DSDI»sI=n. 

(Does not read tape again.) 

To run interactively: 

Same as aboves except to do W command must first do? 
QUTPUTsLISTFIL. 


C170 DSDLI information can be found in Chapter 10 of the 
NOS SYSTEM MAINTENANCE Manual. 


A170 OSOI info can be found in document ARH3060 -- GID 
for A170 NOS/S2. 
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E4.7 4170 NOS SHUTOOWN 


E4e7 ALZC_NOS_ SHUTDOWN 


Before leaving the mactines it is necessary to bring NOS 


down. If NOS has crasheds a level 3 deadstart must be attempted 
even if the only reason is to bring NGOS down. To bring NOS downs 
cdo the following: 


1) 


2) 


3) 


4) 


Enter: 


CHE 

The screen will display: 
CHECKPOINT SYSTEM. 
Enter? carriage return 


Make sure no mass storage device has a checkpoint raquested. 
To do thiss enter? EsM. If the display shows there are no 
"Cs in the status fields then all devices are checkpointed 
and you may continues 


Enter: 
STEP, 


Push deadstart button. 


E4e8 INTERIM MEMORY LINK. STORAGE MOVE CONSIDERATIONS 


The following precautions must be taken when running dual 


state with the Interim Memory Link. 


1) 


2) 


3) 


4) 


Drop IRHF170» PASSON and all permanent file partner jobs 
before doing ¥*BYEVE (via 2-STOP.) 


Do not roftflout IRHF17Gs PASSGN or permanent file partner jobs 
at any time. 


Before doing a CHECKPOINT SYSTEMs drop IRHF170» PASSON and 


ail permanent file partner jobs (via 2eSTOP.) 


If the system crashes a NOS/7A170 tevel 3 deadstart is the 
oreferred action. If for some reason you must do an MCU 
recovery (REC command) do the following? 


- Clear word 17(8) via: 
99. 
1790. 
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E4.0 DUAL STATE DEADSTART AND OPERATION 
£4.28 INTERIM MEMORY LINK STORAGE MOVE CONSIDERATIONS 


- Enter REC on the MCU console. 

- Finish up in A17C coniy mode (i.2@2s9 do not do an UPMYVE)»s 
then do a level 3 deadstarte If you bring up NOS/VE again 
without doing a ftevel 3 deadstarts the resuits are 
unpredictable. 


E49 NOS/VE_ INTERACTIVE FACILITY OPERATION 


E4.29.1 QPERATOR INITIATION 


To bring up the NOS/VE interactive facility do the following: 
1) Bring up NOS/VE. 
2) Bring up NAM 


At the system console enter: 
3eNAM, 


3) If IAF is not up at control point ls enter: 
IAF. 


4) Bring up A170 part of interactives 
= TAFNVE. 
Control} point two must be free or roltdoutabie (ieee. NAM should 


not be there). This atso brings up PASSON and the MLI subsystem 
control points. 


E4.9.2 QPERATOR TERMINATION 
To terminate NOS/VE interactive any of the following may be 
done?’ 


- 3.,CFO.DIsAP#TAF. {3 is the NAM control point number) 


This is the preferred method.» To bring NOS/VE interactive 
back ups you must first do a 3.CFO.ENs AP=TAF. 


~ 3.CFO.DI»sNE. (3 is the NAM contro! point number) 
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£4e922 OPERATOR TERMINATION 


This terminates the entire network including IAFsRBFs etc. 


£4.29.3 OTHER OPERATOR CAPABILITIES 


Teo send a “shutdown warning” to all terminais logged on to TAF 
do: 


32CFO.~IDsAP=TAF. (2 is the NAM control point number) 
To send a message to ali terminals do? 
3.CFO.MSGsALL»mesagee (2 is the NAM control point number) 


PASSON kas the ability to record various types of diagnostic 
information. This capability is controlied via the sense 
switches at the PASSON control point. To turn a sense switch 
on foff) at control point N do: 


NeOQNSWX. (N.GFFSWX.) 


Where X is the desired sense switch (1 to 6). The PASSON 
default is ali sense switches off. It wilt take a short 
period of time before PASSON detects a change in a sense 
switch end reacts to ite The sense switches currently used by 
PASSON are? 


Switch #_ use 
1 Network Trace 
2 PASSON Logic Trace To Dayfile 
3 Memory Link Trace To Dayfite 


E4010 TO_RELQAD_ CONTROLWARE FOR THE DARL=LARGE SECTOR 844 


The following commands need to be entered from deadstart 


o0oo0o00 © 


Push D/S button 
Select "U" display 
Select "S" display 
Select TYPE=3 
Select CM=1 

Select CH=1 
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E4210 TO RELOAD CONTROLWARE FOR THE DAHL-LARGE SECTOR 844 


Select €0=0 

Select UN=the unit number of the system pack (43) 
Sefect "M" display 

Carriage return 

Tyre in "CW MAB 22" carriage return wait until LOADED 
Then redeadstart using section 1 


ooo 6085 


E4.1021 ROUTE AN INPUT FILE FROM C170 TO C180 


Through the system consoles enter: 
Type 


X.DIS. 

USER» As B. 

GETsfilename. 

where filename identifies the input file to be routed. 
ROUTE sfilenamesDC=LP,»FC=RH. 


E4ell K_ DISPLAY _ASCIT 


Support of 6-12 ASCII from the console (K display) causes the 
following changes: 


INPUT IRANSLATED_ TO. INOUT_ ITRANSLATEO 10 

41 . /{ C 

42 " /) ] 

1/3 # {+ > 

74 $ /- < 

75 {reversed /) /= ° 

16 ; 1% * (single quote) 
17 ? 4] / 

18 { /» 3 

19 } 4A to /Z a- z (lower case) 
/0 . (underscore) 


{The major incompatibilities with earlier systems are for 
cherecters for 3; and '. To get a semicotons type /6» to get 
a * (single quote)»s type /* 
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E520 ARDEN_ HILLS DEVELOPMENT LAB SUPPORT BY INTEGRATION 


What we have established in the lab so far is the following: 


A 600 tape capacity tape rack for general uses If you project 
would tike to reserve a section of this tape racks contact Tim 
McGibbon or Bonnie Swierzbin. 


A tape and disk cabinet for storage of system support 
materials which this project will manage and keep up to date. 
(If you have been using this cabinet for unauthorized storage 
- beware. We have the key to the tock!) More will be 
published about the contents of this cabinet laters and a 
cabinet index will be posted in the tab to help locate where 
things are supposed to be placed within the cabinet. This 
cabinet is currentiy located in the southeast corner of the 
labs is 6 Ft. 8 ine talis gray in color and with stiding 
door. 


A two-level documentation rack for system documentation 
listings. This contains the current build compilation listing 
and listing of the NOS/VE PPU routiness system link map. This 
rack is along the west wall at this time. 


A desk documentation rack for reference manuals and Tom 
McGeets collection of “how to™ goodies. The objective is to 
have this reference information at arm's length of the 
consoles but it is currently on top of the two-level unit by 


the West wall. 


At or near the console is a smail notebook containing the NOS 
System Programmer's Instants NOS Application Programmer's 
Instants and the 180 Instruction codes. 


Feel free to examine and use all of the above materials white in 
the lab. Do not remove or abuse any of these materialss. Please 
notify Tim McGibbon or Bonnie Swierzbin of any problems or 
deficiencies of these materials. Leave a note if we are not 
availabie. 
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APPENDIX_A_NOS/VE_ BACKGROUND DOCUMENTS 


1.0 Hardware Overview 
1-1 An introduction to CYBER 180 
1.2 C€18C Instant 


123 Model Independent General Design Specification ~ ARH1700 


2290 NOS Reference Manuals 
2el XEDIT V3.0 - 60455730 
2e2 IAF V1.0 User's Guide — 60455260 
2.3 NOS Reference Manual -— Vol ls 60435400 — Vol 2s 60445300 
224 NOS Instant 
2.5 NOS Operators Guide ~- 60435600 
226 NOS Diagnostic Handbook 
2e7 NOS A170 ERS 


228 NOS A170 GID — ARH3060 


3.0 NOS/VE Reference Documents 


3e1 Program Interface ERS - ARH3610 — obtained from Karen 
Rubey (482-3966) or via SES.TOOLDOC 


3.2 Command Interface ERS — ARH3609 = obtained from Karen 
Rubey (482-3966) or via SES»~TOOLDOC 


3.3 WNOS/VE Procedures and Conventions - SESDO1O - obtained by 
SE€S.TOGLDOC 


324 Listing of all NOS/VE Modules - obtained by 
SESsDEVI.LISTNVE.» See Integration Procedures Notebook 
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for detaiis. 
NOS/VE Internal Interface Maintenance Procedures 
Memo available from S.C. Wood. 
Integration Procedures Notebook 
Obtained by: 


Acquires TIPNDOC/UN=DEVL.» SESePRINTsIPNDOC. 


4.C Toots Reference Documents 


CYBIL Interactive Debugger - ARH3142 
SES User's Guide - ARH1833 

CYBIL Specification — ARH2298 

C180 Assembler ERS - ARH1693 
Simulator ERS — ARH1729 

VEGEN ERS — ARH2591 

VELINK ERS - ARH2816 

Simulated I1/Q0 ERS — ARH3125 

Object Code Utilities ERS -— ARH2922 


CYBIL Implementation Dependent Handbook - ARH3078 
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F1.0 INTRODUCTION 


F1l.0 INIRODUCTION 


Fl.1 PURPOSE 


The purpose of this document is to give an overview of the 
NOS/VE system (formerly caified HCS) from the following 
perspectives: 


~ Adding user tasks (tests) 

- Modifying NOS/VE components 

~ Adding new NGS/VE components 

- System usage - hardware and simulator 
- Hints 
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F2.0 ADDING USER TASKS TO NOS/VE 


F2.0 ADDING USER TASKS _TO_NOQS/VE 


F2e02.1 INTROOUCTION 


A user task can be defined as a group of modules tinked 
together that will execute in the fuser ring* of NOQS/VE>» 
currently ring 11. This task may make catlIs to any gated entries 
within task services (rings 1 through 3) if the cat! bracket will 
allow the call. Data defined within task services may not be 
referenced from rings 4-15. 


F2.022 USING THE VE LINKER 


The general format of the LINK command is: 
SES.VELINK LFL=CYBILI8 LPFELIBLCB CFL=LGO NS=LIBX 


The LPF earameter specifies the file containing Virtuai 
Environment Linker variables that control the tlinkage,. If the 
LPF parameter is not specifieds these variables default to values 
provided by the VELINK procedure. The values for both the LFL 
and QOFL parameters may be anything the user requires - it is 
these parameter that define the makeup of a given user taske The 
VE Linker ERS should be consulted for a detailed description of 
the available parameters. 


Every LINK command creates one unique user task. The value 
for the NS parameter must be unique among all user tasks in a 
given virtual environment build. The value given must be 4 
characters and cannot be either MTIRX or STSXs as these values are 
used for monitor and task servicese 


The following example should heip to clarify how to make the 
modifications. Suppose we want to create two user tasks. The 
first requires object files A and B from the current users 
catalog and file CC From catalog INT2. The second task requires 
object files D and — from the current catafiog and tibrary file 
Li. The necessary commands are: 


ACQUIREsCC/UN=INT2 
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SES e«VELINK LFL=CYBILIB LPFSLIBLCB OFL=(AsBsCC) NS=LIBX 
SES sVELINK LFL={LlsCYBILIB) LPF=LIBLCB OFL=(DsE) .. 
NS*LIBZ 


There are five things to note about this example: 


1) The use of multiple values with the LFL and OFL parameters (up 
to 10). 

2) The fact that local files are referenced first by the tinker 
before they are searched for in the user's catalogs 

3) The use of a continuation (..) card. 

4) The unique NS values LIBX and LIBZ. 

5) The assumption that CYBILIB exists in the current catalogs or 

is already tocal te the job. If neither of these cases is true» 

then CYBILIB must be ACQUIRE'd from the catalog which contains 

the desired version. The same assumption holds for LIBLCB. 


The changes to be to the VELODCM file are described below. 
Immediately after the directives: 


LOADJOB STS*X 
directives of the format: 
LOACLIB NS PNAWE 


shoutd be placed. There should be one directive per user task 
(iee@e» one per user task LINK command In the VELDCM file). The 
NS parameter value must be the same as the value specified for 
the NS parameter on the LINK command. The value for PNAME may be 
any one to eight character name and is the name of this ‘program? 
when it resides on the NOS/VE "tibrary't,. 


It is important to note that all code and data must fit into 
real memory at the time of loading and deadstart. The simulator 
imposes a 500K (16M with next release) byte restriction on 
maximum size and the hardware is restricted to 2M bytes. If the 
memory required exceeds the default maximum of 7AQ00 (16) bytes,» 
then the VELOCM file must be changed to reflect this. The size 
of the page table must be increased so that it has 2 to 4 times 
as many entries as the number of real memory pages. The page 
table size is changed in the VELDCM file in three different 
places» howevers it is not just a simple substitution. 
Assistance should be obtained when any VELDCM file modifications 
are required. The following diagram shows the virtual 
environment after loading: 


memory 
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F2.0.2 USING THE VE LINKER 


Agar ess. “HS -==> (Utes e= aan + 
+ Page Table } 


: Monitor ; 
+ Task ; 
; Services H 
$ we eee et 
; Library H 
: Directory 3 
few een — me 
; User : 
$ Task(s) H 
+; (Library) $ 
$eroee— oo s 


Using the exampie from aboves the two directives to be added 
to the VELDCM file are: 


LOADLIB LIBX PROGA 
LOAOLIG8 LIBZ PROGB 


The names PROGA and PRCGB can be whatever is desireds but must 
be uniaque within a single NOS/VE build. 


To execute PROGA»s the following NOS/VE command is used; 
EXEC PROGA *string? 


One finat note about the VELDCM file. One of the tast 
commands is a *DM ALL* command which produces a hex dump of the 
virtual envircnment file. This command may be removed if the 
dump is not wanted. 


When using the VE Linker specifically to produce NOS/VE 
systems it is recommended that the procedure NVELINKs = as 
described in the Advanced Systems Integration Procedures 
Notebook, be used to produce these systems. Use of any other 
procedures may Jead to erroneous versions of interrelated 
software components. , 
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F3.0 EXECUTION 


F3e1 INTRODUCTION 


NOS/VE will run on either the C180 hardware or the simulator. 
Any differences between the two are resolved by NOS/VE itself or 
by the erocedures used to run it. 


NOS/VE provides three different types of commands. The first 
type allows access to most of the software facilities within the 
systems such as? . 


Execution Management 
Logical Name Management 
Task Management 

File Management 

Segment Management 
Memory Management 

Heap Management 

Signal Management 


The second type provides a debugging capability to be used 
within an executing task. The features availabte are? 


Breakpoint 

Trace Back 

Register Manipulation 
Memory Manipulation 


Both of the first two types are available on both the hardware 
and the simulator. The third type of command is available only 
on the hardwaree These commands are processed by the PPU console 
drivers and offer the following features: 


Memory Manipulation 
Register Manipulation 
Print Memory 

OS Displays (Dayfile) 


NOS/VE currentty supports a single job and multipie tasks 
within that job. A task may be executed synchronously or 
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F321 INTRODUCTION 


asynchronously with other tasks. 


F322 NOS/VE_COMMANDS 


NOS/VE commands ation the user access to a targe number. of 
functions provided by the system. In generals any parameter to 
one of these commands may be either an explicit value or a 
fogical mame space (LNS) variable. One exception to this is the 
use of task status blocks or signal control blockss which must 
always be LNS variablese <A ltogical name space is associated with 
a jobs a fact which must be considered when running multiple 
tasks. 


The following types of LLNS variables and parameters are 
available: 


INTEGER 

CHARACTER 

NAME 

ROGLEAN 

VSTRING 

POINTER 

SIGNAL CONTROL BLOCK (temporary for HCS onty) 
TASK STATUS BLOCKS 


Withir the descriptions which follows, optional parameters are 
enclosed in square brackets ([€]). 
F3.221 DECLARE 

This command is used to create variables within the logical 
name space of the current jobe 
Syntax: DECLARE NAME TYPE 
NAME = LNS variabie names 1 to 31 characters. 


TYPE - Variable types must be one of the following: 


INTEGER - A 64 bit integer. 
BOGLEAN - The value TRUE or FALSE. 
POINTER - A pointer to cell. 

SCB ~ A signal contro! block. 


VSTRING ~ A STRING (*) variable. 


Build Ny June 1981 


F3=3 
NOS/VE USERS GUIDE 
07/29/81 


F3.0 EXECUTION 
F3e2e1 DECLARE 


CHARACTER - A single character. 
TSB ~- A task status block. 


F3.2e2 REMOVE 
This command is used to remove a variable definition from the 
logical name space of the current job. 


Syntax: REMOVE NAME 


NAME - LNS variable names 1 to 31 characters. 
F3.223 PFSTATS 


This command is used to disptay the fotltowing page fault 
statistics: 


avail oa —- Number of times a page was found in the 
available queue. 

avail mod q ~ Number of times a page was found in the 
available/modified aueue. 

valid in pt - Number of times the page was found in the page 
table. 

no memory ~ Number of times a page fault could not be 
satisfied because no real memory was 
availabie. 

focked - Number of times a page fault could not be 


satisfied because the page frame was locked (10 
was active). 

on disk - Number of times a page was found on a diske 

pt full -~ Number of times a page fault could not be 
satisfied because an empty entry could not be 
found in the page table. 


cio reject - Number of times a page fault couid not be 
satisfied because of an I/0 error. 
new page - Number of times that a new page was created. 


syntax: PFSTATS 
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F3.224 TSTATUS 
This command is used to display the status of all currently 
active taskse The following information is displayed? 
Task Name 
Execution Time Used 


Number of page faults 


syntax: TSTATUS 
F3.2225 TMCYCLE 


This command causes a task to give up its turn for execution 
until ali other ready tasks have had at least one chance to 
executes 


syntax: TMCYCLE 
F3.226 TMDELAY 

This command causes 3 task to be kept from executing for a 
specified number of miiliseconds. 


syntax: TMDELAY MS 


MS - Number of mittiseconds to delay. 
F3.227 TMABORT 


This command causes the current task to be aborted. 
syntax: TMABORT ®MES* 


MES - A string to be displayed when the task is aborted. 
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F3e2.8 TMEXIT 


This command causes the current task to terminate normally. 


syntax? TMEXIT 
F3.22.9 EXECJEX 
This command causes a new task to be created and executed 
subordinate to the current task, 
syntax? EXEC PROGRAM [PARAM] CTSBI 
EX PROGRAM [PARAM] CTSB] 


PROGRAM =- The name of the program on the system 'library' to be 
executed. 


PARAM - A string that is passed to the program via the 
pregram headere 

TS$8 - Qne of the following: 
DEBUG - Specifies that the task is to be 


executed by the debug processor. 
The task is run synchronously. 


A - Specifies that the task should be 
executed asynchronous lys but 
without any task status biock 
being used. 


Other non-blank - Speci fies that a task status 
block variable of the name given 
is to be created in the current 
Job's LNS and the new task is to 
be run asynchronously with the 
current taske. The task name _ in 
this case will be the value given 
for this parameter. The user can 
determine the status of a task by 
printing the value of the task 
status block. 

If the parameter is omitteds the task will be run 

synchronously. 
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F3e2e¢10 TMTERM 


This 


command is used to terminate a specific task and all 


callees of that task. 


syntax? 


TMTERM TASKNAME 


TASKNAME - The name of the task to terminate, 


F32e11 SMOPEN 


This command causes @ segment access open to be performed on a 
focal files or causes a transient segment to be created. 


syntax? 
PYA - 
NAME — 
SEGNUM- 
R1 = 
Ri - 
ATTR - 


SMOPEN PVA CNAME] CSEGNUM] €R1]7 €R2] CATTRI 


The name of an LLNS pointer variablie to receive the 
segment pointer. 


The name of the local file (1 to 8 characters) to open 
as a segment. If this parameter is omitteds a transient 
seament is created. 


The segment number to be assigned to the segment. If 
this parameter is omitteds an unused segment number wiil 
be chosen. 


The R1 value for the segment. If this parameter is 
omitteds ll is used. 


The R2 vatue for the segment. If this parameter is 
omitted, 11 is used. 


The attributes of the seqment. <A tegal valiue is any 
valid combination of the following letters: 


- Read 

~- Write 

- Execute 

- Binding 

Execute Local Privilege 
- Execute Global Privilege 
- Wired 

=~ Stack 

- Cache Bypass 


ODA eH Ox EH 
t 
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S - Shared 
Q - Sequential Access 


The default is RW. 

F3e2e212 SMCLOSE 

This command causes a segment of the current task to be 
removed from that task's address space. 
syntax? SMCLOSE PVA 
PYVA —- A pointer to a celle The segment represented by this 

pointer wild be ciosed. 

F3.22213 SMCHANGE 

This command atltows some of a segments attributes to be 
changed after it has been created. 
syntax: SMCHANGE PVA [R1] (R2} CATTRI 
PVA — Same definition as SMOPEN 
Ri - Same definition as SMOPEN 
R2 =~ Same definition as SMEPEN 


ATTR - Same definition as SMOPEN. 
F3«2e214 MMADVI 


This command causes the system to be notified that the 
specified range of virtual memory should be paged in as soon as 
possible. 
syntax: MMADVI CPVA] CLEN] 


PVA = A pointer to the first byte of virtual memory to be paged 
ine The default is NIL. 


LEN —- The number of bytes to page ine The default is l. 
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F3.2.2215 MMADVO 
This command notifies the system that the specified range of 
virtual memory may be paged out (removed from the working set). 
syntax: MMADVG CPVA] CLEN] 
PVA —- Same as in MMADVI» except that memory Is paged oute 
LEN - Same as in MMADVI» except that memory is paged out. 
F3.2216 MMADVODI 
This command performs the functions of both the MMADVO and 
MMADVI commands. The page out is performed first. 
syntax: MMADVG CPVACQ) CLENO] CPVAI] CLENI] 
PVAQ - Same as in MMADVC. 
LENO — Same as in MMADVO. 
PYAI =~ Same as in MMADVI. 
LENI = Same as in MMADVI. 
F3e2e0e17 MMWMP 
This command is similar to the MMACDVO command except that the 
pages are written to disk immediatly. 
syntax? MMWMP CPVA} [LEN] CWAITI 
PVA - Same as MMADVO. 
LEN = Same as MMADVO. 
WATT -—- The vatue TRUE if the user desires to wait until aii 


paging I/0 is completes otherwise FALSE. The default is 
TRUE. 
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F3.2218 MMFREE 
This command causes the pages representing the specified range 
of virtual memory to te reteasede 
syntax? MMFREE PVA [LEN] 
PVA —- same as in MMADVI. 
LEN - same as in MMADVI. 
F322219 CONPVA 
This command converts a process virtual address (PVA) to a 
real memory address (RMA). 
syntax: CGNPVA PVA (MODE] 
PVA - The pointer to be converted to an RMA. 
MODE —- One of the following values: 


DIRECT =- The specified PVA is to be converted. This Is 
the default value. 


INDIR = The specified PVA is a pointer to the PVA toa be 
converted. 


F302e20 HPINIT 


This command causes a heap to be created and initialized. 
syntax: HPINIT HEAPP LEN 


HEAPP - The name of an LNS pointer variable. It wilf be set to 
point to the heap. 


LEN — The ftength of the heap in bytes. 
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F322e221 HPALLOC 

This command allocates space within a previously created 
NeaPpr 
syntax? HPALLOC PTR LEN CPAGECROS)] CZERGI] HEAPP 


PTR - The name of an LNS pointer variable. It will be set to 
point to the allocated area. 


LEN - The number of bytes to allocate. 


PAGECROS~ This parameter has no affect. It is inctuded for 
compatibility. 


ZERC ~ The value TRUE if the allocated area is to be preset to 
the value zero or FALSE if it is to be teft as is. 
The default is FALSE. 

HE APP ~ A pointer to the heap in which the space is to be 
allocatec,. 

F3.2e22 HPFREE 

This command frees a block of space previously allocated from 
@ heape 


syntax? HPFREE PTR HEAPP 


PTR - The name of an ULNS pointer variable which points to the 
tlock to be freede 


HEAPP— A pointer to the heap in which the bitock is attocated. 
F3.22e23 SHINIT 


This command is used to initialize a signal control block. 
syntax: SHINIT SCB CTYPE] CVSTR] 
SC8 - The name of an UNS signal control biock variable to be 


initialized. 
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TYPE - The signal type to be associated with the SCB. Must be 
one of the following: 


EVENT 
SEME 
ICRESP 
MESSAGE 


VSTR - If TYPE is messages then this parameter specifies a string 
variable whose size is the maximum message size allowed 


when using this SCBs and whose ftlocation is where the data 
will be placed. 


F322224 SHSEND 
This command causes a send signal operation to be performed on 


the specified signal control block. 


syntax: SHSEND SCB CINT] C*STR*] 


SC8 - The LNS signal control block variable to which the signal 
is sente 
INT -— Integer value to be sent with the signal 


STR - A string (Cin aquotes) to be sent as data along with the 
signal. If both INT and STR are specifieds STR takes 
precedence, 


F3.2225 SHWAIT 


This command causes the current task to wait until a specified 
amount of time has passeds or until any of up to three signats 
are sente 


syntax? SHWAIT CITIME] (SCB1] £€5C82] ($CB83] 


ITIME- The number of milliseconds to wait. If this parameter is 
omitteds infinity is used. 
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SC8i - Up to three LNS signal control biock variables to wait for 
a signal on. 


F3e2e26 CHANGE LNS VALUE 


This command attlows the value of an tLNS variabte to be 
changed. Signal control block and task status block variables 
cannot be changed. 

Syntax: LNSN = NY 
LNSN — The name of the LNS variable to be changed. 


NY - The new vatue. 


F3.22.227 PRINT LNS VALUE 


This command causes the value of an LNS variabie to be 
displayed. 
syntax: LNSN 


LNSN — The name of the LNS variable to be displayed. 


F3.22.28 ECHOINP 


This command causes ali command input to NOS/VE to be echoed 
back to the output device. This command is useful only when used 
as the first command to a batch mode simuletion. 


syntax: ECHOINP 
F3.2.29 STOPSIM 
This command causes NOS/VE to stop execution via a CPU hait 


when running on the simulator. 


syntax: STOPSIM 
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F3.2230 SSET 


This command 


allows some of the NOS/VE control parameters to 


he changed dynamically. 


syntax: SSET CPN CNV] 


CPN — The name of the control parameter being changed. The vaiue 
must be one of the following (entries followed by an * are 
not intended for general use): 


QUANTUM = 


MAXIDLE* ~ 


TICKTIME*- 


DFOELAY* 


KEYMAX 


STEPCNT* 


DBRING 


PQTHRESH*— 


KM = 


MM = 


Basic task time slice (microseconds) for ail 
tasks created after the execution of this 
command. 


Maximum amount of time spent in monitecr idle 
loop before tooking for lost interrupts. 


Used for paging control. 


Minimum amount of time between the issuing of 
dayfile messages. Used to stow down the 
scrolling action of the console dayfile 
display. 


Maximum vaiue of the id field from a keypoint 
that will be placed in the keypoint buffer. 
Any keypoint with an id Field greater than 
this value will be ignored. 


Maximum number of monitor requests allowed 
before monitor goes into wait loop. 


Lowest ring that can be executed white in 
debug mode. 


Number of pages kept in the page queuese 


Keypoint mask used for every task created 
after execution of this command. 


Monitor mask used for every task created 
after execution of this command. 


User mask used for every task created after 
execution of this command. 
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PITVAL*® -—- The value that the PIT $%Is reset to after 
every PIT interrupt. 


CISDELAY ~ How often {milliseconds) the system status 
display (3 lines on the consote) is updated. 


NV - The new value for the specified control parameter. If NV 
is emitteds the current value will be displayed. 


It is important to note that these commands are used primarity 


for hardware and monitor debuaging and may change or disappear at 
any time. 


F302031 FMCREATE 


This command makes a file known to the system. 
Syntax? FMCREATE FILENAME 
FILENAME -~ The name of the file being created (1 to 8 
characters). 
F302e32 FMDELETE 
This command detetes a file previousty made known to the 
system with the FMCREATE command, 
syntax: FMDELETE FILENAME 


FILENAME —- Name of the file being deleted, 
F302233 FMDQWNAU 


This command identifies bad areas on disk and keeps them from 
being allocated. j 
syntax: FMDOWNAU UNIT CYLINDER TRACK SwWLBUG SECTOR 
UNIT - Unit number of the disk device. 


CYLINDER - Cylinder number, 
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TRACK - Track numbere 
SWLBUG - This parameter is present because of a compiler 
bude 
SECTOR - Sector to be marked as bad within the specified 


unit/cylinder/track» 
F3.3 CONSOLE COMMANDS 


Commands to the system are entered via the console keyboard. 
With the exception of messages to the operating systems all 
commands entered must include a two-character command identifier 
or a two-character operating system display identifier. Some 
commands require parameters» others do not. All command input 
lines are restricted to 60 characters or fess; ail are terminated 
by depressing the carriage return key. 


F32321 DISPLAY CENTRAL MEMORY 


F3e3ele1 Display. - Partial Mode 


The following commands provide display of only the right-most 
60 bits of central memory words (they use the 60 bit = PPU cm 
read/write instructions). 


F3.3-lelel DP» <ADDRSD 


Displays an installation-specified number of central memory 
words3 two words are displayed per display tine atong with the 
byte address of the Jleft-most word of the tine, 


<addrs>: <A 1-8 digit hexadecimal real _ memory byte address which 
defines the first word to be displayed. The specified 
address is forced to zero module eight if it is not so 
specified by the command. 


F3e3eleled DP» + 

Increments the most recentiy specified memory address and 
displays a set of memory words which are contiguous with those 
most recentiy displayed. This command is used to “rot!i®™ forward 
through memory. 
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F3.23e12123 DP»~ 


F3e30121.23 DP »- 


Decrements the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recentiy displayed. This command is used to “rolt" backward 
through memory. 


F32321.1.24 DP 


This command may be used to reinstate the most recent central 
memory display after the screen has been used for other 
purposes. 


F3.321.2 Display. - Euyll Mode 


The following commands provide dispiay of ali 64 bits of 
central memory words. There are a number of characteristics of 
these commands of which the user should be aware: 


; These commands use the 64-bit central memory access 
mechanisme 


F3e3el1e2e21 DF»<ADDRSD 


Displays an instaltation-specified number of central memory 
words; two words are displayed per display line along with the 
byte address of the teft-most word of the line. 


<addrs>: A 1-8 digit hexadecimal real memory byte address which 
defines the first word to be displayed. The specified 
address is forced to zero module eight if it is not so 
specified by the command. 


F3edele2e2 DF» + 


Increments the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayede This command is used to "roll" forward 
through memory. 


F3.e3e10e223 DF »- 
Decrements the most recentiy specified memory address and 
displays a set of memory words which are contiguous with those 


most recently disolayed. This command is used to "roli™ backward 
through memory, 
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F30301.2224 DF 


This command may be used to reinstate the most recent centrai 
memory display after the screen has been used for other 
purposes. 


F3.3.22 CHANGE CENTRAL MEMORY 


F3.3.2.1 Change-Partial Mode 


F3e3e2elel CPs<ADDRS>=< VALUED 


This command inserts a specified value into the right-most 60 
bits of a 64-bit central memory word; the lteft-most 4 bits of the 
central memory word are unconditionally set to zero. 


<addrs>: A 1-8 digit hexadecimal real memory byte address which 
defines the central memory word which is to be 


modified. The specified address is forced to zero 
module eight if it is not so specified by the commande 


<value>?: A 16 digit hexadecimal value which is to be inserted 
into the central memory word; ail 16 digits must be 
specified. Blank characters may separate hex digits if 
desired to simplify value specification; for examples 
the two vaiue specifications shown below yield the same 
result: 


valuel 0123456789ABCDEF 
value2 0123 4567 89AB CDEF 


F323.2e22 Change-Full Mode 


This command inserts a specified value into the full 64 bits 
cf a 64-bit central memory word. 


<addrs>: <A 1-8 digit hexadecimal ceagl_memory byte address which 
defines the central memory word which is to be 
modified. The specified address is forced to zero 
module eight if it is not so specified by the command. 


<value>: A 16 digit hexadecimal value which is to be inserted 
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into the central memory word; atl 16 digits must be 
specified. Blank characters may separate hex digits if 
desired to simplify value specification; for examples 
the two value specifications shown below yield the same 
result? 


vaiuel 0123456789ABCDEF 
value2 0123 4567 89AB CDEF 


F323e3 PRINT CENTRAL MEMORY 


F3e3e301 PMe<addrs2ecwords2 


This command provides a jlisting of central memory to aetine 
printer. Four words are listed per line along with the byte 
address cf the left-most word of the tine, 


<addrs>: A 1-8 digit hexadecimal peal memory byte address which 
defines the first central memory word to be listed. 
The specified address is forced to zero module eight if 
it is not so specified by the command. 


<words>: A 1-5 digit decimal value which specifies the number of 
central memory words to be listeds 


A tisting operation may be terminated prior to its normai 
completion by depressing the carriage return at the keyboard. 


F32304 DISPLAY/CHANGE SYSTEM ELEMENT REGISTERS 


F323e4e1 Display Element Registers 


F3e304e2lel DRs<ELID>D 


This command causes display of an installation defined set of 
registers of a system element. 


<elid>d: A two-character system element identifier which 
specifies the element of which registers are to be 
displayed. Valid system element identifiers are listed 
under the section entitled "System Element 
Identifiers", The registers dispiayed for each system 
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element are fisted under the section entitled "System 
Element Registers". 


F3.3-4-2 Change Element Registers 


F3.3242201 CRe<ELID> rs <REGIDD>=< VALUED 


This command permits modification of system element registers 
for which the maintenance channel has write access. 


<elidds: 


<regid>: 


C<valued;3 


A 2 character system element identifier which specifies 
the element of which a register is to be modified. 
Refer to the section entitied "System Element 
Identifiers™ for a fist of valid identifiers. 


A 1-4 character register identifier which specifies the 
register which is to be modified. Refer to the section 
entitled "System Element Registers" for a list of vatid 
register identifiers for each system element. 


A 16 digit hexadecimai value which is to be inserted 
into the register; all 16 digits must be specified. 
Blank characters may separate hex digits if desired. 


F3e32423 System Element Icentifiers 


Following is a list of valid system element identifiers. 


» M2 
» P2 


Identifies the central memory element 
Identifies the central processor unit 


F3e304-% System Element Registecs 


The following subsections lists according to system elements 
those registers which may be displayed and which may be modified 
(assuming that the maintenance channel has write access to the 
specific register). 


F303e04e4e1 CENTRAL MEMORY REGISTERS 


Bulld Ns June 1981 


NOS/VE USERS GUIDE 


F3-20 


07729781 


F32.0 EXECUTION 


F30324e4e1 CENTRAL MEMORY REGISTERS 


REGISTER 
MNEMONIC 


ee ee ee ee ER eee 


F30324e04e2 


REGISTER 
MNEMONIC 


— a ae ee ee 


DEC 
MSL 


F3.325 DISP 


REGISTER NAME 


Status Summary 

Environment Control 

Bounds Register 

Corrected Error Logs Distributor 0 
Uncorrected Error Log ls Distribut 
Uncorrected Error Log 2» Distribut 


CENTRAL PROCESSOR REGISTERS 


REGISTER NAME 


Status Summary 

Environment Control 
Program Address 

Monitor Condition Register 
User Condition Register 
Untranslatable Pointer 

Jobo Process State 
Processor Fault Status 
Retry Corrected Error tog 
Control Memory Corrected Error Log 
Cache Corrected Error Log 
Map Corrected Error tog 
Keypoint Code 

Keypoint Class Number 

Trap Enables 

System Interval Timer 
Control Memory Address 
Controt Memory Breakpoint 
Processor Test Mode 

Model Dependent Word 
Dependent Environment Control 
Maintenance Scan Limit 


LAY PPS PROGRAM ADDRESS REGISTERS 


ACCESS 
ATTRIBUTES 


R 
RIW 
R/W 
R/W 
or 0 R/W 
or 0 RIW 


ACCESS 
ATTRIBUTES 
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F3232521 PP 


F3.2325e1 PP 


This command causes display of the program address register of 
each PPU in the PPS, 


F3.2326 CLEAR DISPLAY 
F3.326.1 CDOe<screen2d 
This command is used to deactivate a currently active 
display. 
<screen>: Is Ls R»s or B to specify teft screens right screens or 
both screenss respectively». 
F3.327 START SYSTEM 


F323-2721 $8 


This command is used during system deadstart after the message 
*PROCEED" is displayed at the console; this command causes final 
initialization to occur and the CPU to be started. The command 
is valid at no other time. 


F3.3.8 HALT CENTRAL PROCESSOR 


F323e821 HT 


This command is used to halt the central processors 


F3.329 START CENTRAL PROCESSOR 
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F323-921 GC 


F3.3.921 §0 


This command is used to start the central processor after it 
has been halted with the HT command. 


F32e3210 CPERATING SYSTEM DISPLAYS 


Various operating system displays are available to the 
console; a specific display may be called by typing its unique 
2é~character identifier and a carriage return. 


F3.3.10.1 Display _[dentifiers._and Descriptions 
DD —- Dayfite of the system job. 
F3.3.211 CONSOLE MESSAGES TO THE OPERATING SYSTEM 


Sinate tine messages of 60 characters or tess may be sent to 
the operating system from the console keyboard, Any line of 
incut from the keyboard is sent to the operating system if both 
of the following conditions are met: 


1. The first two characters of the line do not match aeconsoie 
command or an operating system display identifier. 


2e« The number of characters in the input line equals or exceeds 
1 character, 


F3.4 DEBUG FACILITY 


The debug facility of NOS/VE provides a set of capabilities 
intended to assist in testing of programs which execute under 
control of NOS/VE. Services provided by the facility are task 
criented: selection of the debug facility is at the option of the 
user at the time of task invocation. NOS/VE uses the CYBER 180 
debug hardware to provide these capabilities. 
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F304e.1 SUMMARY OF DEBUG FACILITY SERVICES 


Set Breakpoint: Selects a program interrupt which is to 
occur upon occurrence of a specified 
condition within a specified virtual 
address range. 

Remove Breakpoint: Deselects a previously setected program 
interrupt. 

Change Breakproints Changes the virtual address range of a 
previously specified breakpoint. 

List Breakpoint: Provides a list of currently selected 
breakpoints and associated conditions. 


Provides information relevant to stack 
frames associated with an interrupted 
procedure and its predecessor 
procedures. 


Trace Back? 


Display Stack Frame: 


Display Register: 


Change Register: 


Display Memory: 


Disolay selected information from a 
specified stack frame. 


Display the contents of a specified 
register of an interrupted procedures. 


Sets a specified value into a specified 
register of an interrupted procedure. 


Displays the contents of a specified area 


of virtual memory. 


Change Memory? Sets a specified value into a specified 


location of virtual memorye 
Runs Invokes program execution after a 
selected program interrupt has occurred. 


F3e4e2 DEBUG FACILITY COMMANDS 
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F324e221 Parameter Definitions 


<name> 232 1-8 character breakpoint name 

Ccondition> 22= READIWRITEIRNIS BRANCHICALLIDIVFLT: ARLGS; 
AROVFLIEXQVFLIEXUNFLIFPLOSIFPINDEF?S INVBDP 

<base> %83= process virtual address 

<offset> %3= integer 

<hength> 22 integer 

Cframe> 23= 122100 

Ccount> %*32 1.2.210C 

<regid> %3:= XIASP 

<regno> 332 0.2215:0..0F (16) 

<hex uvstring> *:= thex string! 

<time>d 232 1.42(2**31)-1 

<vstring> %:2= 'charstring! 

<datatype> t= HEX ASCIISASCIDECIMAL? DEC 

<selector> 2:= FULLIAUTO? SAVE 


F3.4.2.2 Command Descriptions 


Within the descriptions which follows optional parameters are 
enclosed in brackets. fPefauilt values for optional parameters are 
also defined, 


F304e2e201 SET BREAKPOINT 


Selects a program interrupt which is to occur upon occurrence 
of a specified condition within a specified virtual address 
range. 


syntaxs BP <named <conditicon> (<base>] [(<offset>] [<length>] 


The base parameter is required when specifying a new 
breakpoint name; offset and tength specifications are optional in 
this casee When adding a new condition selection to an existing 
breakpoints bases offsets, and tlength parameters may not be 
specified. 


Bases offsets and tength parameters define the desired virtual 
address range: <base>d + <offset> yields a first-byte-address; 
first-byte-address + <length> -1 yields a last byte address. 


Default parameter values? 


<offset>: 0 
<length>: 1 
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F3.4e2e2e2 REMOVE BREAKPOINT 

Deselects a previously selected program interrupt. 
syntax? RB <name> [<condition>] 

If onty the name parameter is specifieds, all conditions 
associated with the breakpoint are deselected and all evidence of 
the breakpoint is removed, If the condition parameter is 
specifieds only that condition is deselected} howevers if the 
specified condition is the onty condition selected, ail evidence 
of the named breakpoint is removed, 

F304e2e22e3 LIST BREAKPOINT 


Provides a fist of currentiy selected breakpoints and 
associated conditions. 


syntax? LB E<name>] 

If the name parameter is specifieds information itis dispiayed 
for the named breakpoint only. If the name parameter is not 
specifieds information is displayed for all currently defined 
breakpoints. 

F323 04020224 CHANGE BREAKPOINT 


Changes the virtual address range of a previously specified 
breakpoint. 


syntax: CB <name> <based [([<offset>] C<tength>d]) 

Bases offsets and tength parameters define the desired virtual 
address range: <base> + <offset> yields a first-byte-address} 
first-byte-address + <length> -1 yields a tast byte address. 


Default parameter vatues: 


<offset>: 0 
<jiength>: 1 


F304e2e205 TRACE BACK 


Provides information relevant to stack frames associated with 
an interrupted procedure and its predecessor procedures, 


Information displayed for each selected stack frame consists 
of: 
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F3.0 EXECUTION 
F3 04020225 TRACE BACK 


- Stack frame number} 

—- Current P-address of the associated procedure} 

- Virtual address of the start of the stack frame; 
- Virtual address of the stack frame save areas 


syntax: TR [<frame>] [<count>] 


The frame parameter specifies the number of the first stack 


frame for which information is to be displayed. (Stack frame 
number one is associated with the interrupted procedures stack 
frame two is associated with the interrupted procedurets 


predecessors etc.) 


The count parameter specifies the total number of stack frames 
for which information is to be displayed. 


Default parameter values! 


<frame>: 1 
<count>: 1 


FB e4e2e206 DISPLAY STACK FRAME 

Display selected information from a specified stack frame. 
syntax: DOS €<framed>] <setlector>d] 

The frame parameter specifies the number of the stack frame 
for which information is to be displayed. (Stack frame number 
one is associated with the interrupted procedures, stack Frame two 
is associated with the interrupted procedure's predecessors 
etce) 


The selector parameter identifies a region of the specified 
stack frames 


“AUTOS Causes the automatic region of the stack frame to be 
displayed. . os Nia oe 

SAVE? Causes the save area of the stack frame to be 
displayed. 

FULL? Causes both the automatic and save areas of the stack 


frame to be displayed. 
Default parameter vaetues: 
<frame>: 1 
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F304%e2e2e6 DISPLAY STACK FRAME 


€selector>: FULL 
F304e2e2e7 DISPLAY REGISTER 


Display the contents of a specified register of an interrupted 
proceduf ee 


syntax? DR <regid> (<regno>)] C<datatype>] 
Default parameter values? 


€regnod: 0 
<datatype>: HEX 


F304e2e2e8 CHANGE REGISTER 


Sets a specified value into a specified register of an 
interrupted procedures 


syntax: CR <regid> <regno> (<datatype>] <vstring> 
Default parameter vatues? 

<datatype>: HEX 
F304e2e2e9 DISPLAY MEMORY 

Displays the contents of a specified area of virtual memory. 

syntax: DM <base> €<fength] 
Default parameter values? 

€<length>: 8 
F304e2e2210 CHANGE MEMORY 


Sets a specified vatue into a specified location of virtual 
memor Ye 


syntax: CM <base> <hex_vstring> 
F3e4e2e2e11 RUN 


Invokes program execution after a setected program interrupt 
has occurred. 


syntax: RUN <time> 
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F304e2e2e11 RUN 


The time parameter specifies the maximum number of 
microseconds the program tis to execute; a program interrupt will 
occur upon attaining this execution limit. 

Default parameter values: 


<timed: Infinite 
F325 ERROR CODES 
Error codes are dispiayed as 6 hex digits in the foltowing 
format? 


AANNNN 


The AA fietd designates the functional area that issued the 
error. The possibile values are! 


01 - Signal Handter 


02 - Circular Buffer Handier 
C3 —- Heap Manager 

04 - Mise Task Services 

05 - N/A 

06 - File Manager 

O7 - N/A 

C8 - Task Manager 

09 - Memory Manager 

OA ~- Job Manager 

OC - Loader 

OD = Central 1/0 

CE ~ Dispatcher 

OF —- Command Language Processor 
10 = Logical Name Manager 

11 - Debug Processor 

12 - Configuration Manager 


The NNNN field is a detaited error number within the specified 
functional area. 


F3e5e1 DETAILED ERROR CODES 
Atti numeric vatues are given in hexe 
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F3e5eie1 Signal Handier 


timeout 

signal buffer full 

task swapped. 

invalid signat id 
incompatible signal type 
message buffer too smatit 
empty wait list 


F3.5e1e2 Circular Buffer Handler 


ww OO OI w ty be 
onuenwkr ef a 


1 = buffer not initialized 
2 2 buffer full 
3 = message too tong 


F3e5e1e3 Heap. Manager 


None 


F305e164 Misc_ITask Services 


None 


F3e50125 Elle Manager 


KFD not avaitable 

File active 

Fite not active 

PFD not available 

File exists 

File not created 

File open 

Multiple usage 

File not temporary 

OA = File not permanent 

08 = File not attached 

OC = File attached 

OD = File not open 

OF = Invatid KFOL index 

OF = KFD not active 
Z 


OQDONOULWNH 
oununneunne 


10 Invalid PFDL index 
11 PFD not active 
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F3.2521.25 File Manager 


‘12 = Active I/0 
13 = No units configured 
14 = 


No active units 


F3.5.1.6 Jask Manager 


1 = Task not found 


F3.5e1.7 Memory Manager 


Page already in page table 
Page table full 

No free pages 

Locked page free request 
Page not in page table 
Invalid PVA. 

Page frame not tocked 

Page frame not assigned 

- 1E = N/A 


0 ONO OE WN 
“het # © 8 


1F Invalid ring number 

20 Segment table is full 

21 Segment number is in use 
Segment number not in use 


Nil) segment pointer invalid 
Segment number too big 
Cannot change segment number 
Unsupported keyword 


F30501.8 Job Manager 


mS 
Ww z 
ou eee uan 


None 


F3.5e1-9 Loader 


1 = program not found 


F3.521.210 Central 1/0 


=z ICRP not available 

= End of file 

=z Invalid byte count 

= Invalid buffer length 
= Invalid buffer address 


wm & Wh 
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F32521.210 Central I/8 


6 = Invalid MS function cede 
7 = Invalid CIO hardware type 
8 = Feature not supported 
9-40 = N/A 

41 = End of device 


42 = End of allocation 

43 = File not allocated 

44 = File already allocated 
45 = Invalid cylinder 

46 = Invalid track 

47 = Invalid sector 

48 = AUD not defined 

49 = AUD allocated 

4A - 80 = N/A 

Bl = CBD not available 


F325e1e11 Dispatcher 


1 = Invatid task id 
2 = PTL full 
3 = Invalid running job ordinal 


F3.5e1.12 Command Language Processor 


missing parameter 
invalid character 
undefined parameter type 
integer out of range 
unknown command 

unknown syntax 

not supported 

bad. parameter type 

9 = token too tong 

bad combination of parameters 
bad value for pointer 
unknown parameter name 
valid password required 
S$CB not event 


oO Ue W Py 
ee ee ee ee ee 


© 
a) 
aeann en 


F3e50e1+13 Logical Name Manager 


Entry not found 

Type mismatch on put 
Entry already exists 
Tiflegal put request 


Wh 
aes 
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F3.2521.213 Logical Name Manager 


5 = Buffer wrong size 
6 = Buffer too small 


F3e50e1014 Debug. Processor 


Debug not initialized 
Breakpoint name exists 
Base parameter not specified 
Invatid breakpoint condition 
Condition already selected 
Maximum number of breakpoints already set 
Invalid address range 
Invalid breakpoint name 
Condition not selected 
No trap has occurred 
Invalltd stack frame specified 
Register not in stack frame 
Invalid data type definition 
Invalid register type 
Invalid P-reg value 
Invatid A-reg vatue 
Invalid X-reg vaiue 
12 = Invalid selector 
3-OFE = N/A 
OFF = Unused error code 


F3.521.15 Configuration Manager 


OO ousewn 
a ee a ee en 


oe 
© 
oee#erase ew 


1 = Invetid function code 
2 * Not mass storage 
3 = Unit not active 


F3e5e1.16 CPU _BONITOR 


These values are stored in register XE just before NOS/VE halts 
the processor: 


1 = Hardware faiiture 

2 = Task aborted in ring 1 or 2 

3 = Task aborted while abort in progress 
4 = Task executing had negative PIT 

301 = Hardware failure 


Build Ns June 1981 


Far] 
NOS/VE USERS GUIDE 
07/29/81 


F4.0 CODING CONVENTIONS AND SOURCE USAGE 


F4.0 CODING CONVENTIONS AND. SOURCE USAGE 


The conventions presented in this section reflect the current 
state of the NOS/VE systems formerly known as the Hardware 
Checkout System (HCS). The final NOS/VE system will differ from 
the current system in many wayss such as different functienal 
areass new functional areass different naming conventionss etce 
The conventions to be used in. the final NOS/VE system are 
documented in the NOS/VE Project - Procedure and Conventions 
document. The information presented in this section is intended 
to assist users while HCS conventions are stil! in use. 


F4.e1 NAMES 


All global NOS/VE names have the foltowing format: 
AATSNNN 


The AA fieid designates the functional area to which the name 
appliess, and can be one of the followings 


SH - Signal Handler 

HP —- Heap Manager 

FM =~ File Manager 

PM —- Task Manager 

MM ~- Memory Manager 

JM —- Job Manager 

tL - Loader 

CI - Centrai 170 

DS - Dispatcher 

CL - Command Language Processor 
LN - Logical Name Space Manager 
DB - Debug Processor 

CM - Configuration Manager 

OS - General NOS/VE 

MH - Machine Code Breakout 

DM —- Data Management 

MT - Monitor Interrupt Processor 


The T field represents the type of the names and can be one of 
the Following values? 
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F 


4e1 NAMES 


~ Procedure 

- Variabie 

Error Constant 
Keypoint Constant 


Ame vu 
i 


The NNN field is a descriptive string describing the object. 
F4e2 JEXT_INPUT 


NOS/VE contains a routine that alionws text input to be 
performed easilys and without regard to whether execution is on 
the hardware or the simulatore When running on the simulator the 
system executes the I0 machine instruction (opcode FF) which 
reads from the fite specified on the I parameter when the 
simulator was caffled. When running on the hardwares text is 
input from the consolee If more than one task attempts to read 
input at the same time when running on the simulators the ‘first 
task will get the data. If this happens on the hardwares any one 
of the tasks may get the data. 


The name of the routine its CLPSGET_STND_INP and has the 
following declarations 


*call RCLGETS 


The variabie cstring contains the input text and is defined as 
foltous? 


RECORD 
LHIyRHTI & 002255» 
S t STRING (255), 
RECEND3 


The LHI field points to the feftmost character of the string. 
Any number of blanks may precede the first character of the 
string. A semicotion will be added as the tast non blank 
character of the string and the RHI field will potnt to the 
semicolon. 


F4.3 TEXT OUTPUT 


NOS/VE contains a routine that aflows text output to be 
performed easitys and without regard to whether execution is on 
the hardware or the simulator. When running on the sismulstors 
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F4e3 TEXT GUTPUT 


the system executes the ID machine instruction lopcode FF) which 
writes to the file specifled on the O parameter when the 
Simulator was cattied. When running on the hardwares text iis 
output to the dayfiles which is scrolled on the console screen. 
If more than one task outputs to the consoles the outputs will be 
intermixed. NGS/VE does not identify the output as to which task: 
issued it. 


The name of the routine ts CLPSPUT_STND_0DUT and has the 
following declaration? 


*cali RCLPUTS 
Note that the string S is a VAR parameters and as suchs a 


literal string cannot be passed. 


F4.4 COMMAND UTILITIES 


NOS/VE contains various routines that will aid in the process 
of command § cracking. The user could read a tine of text input 
via CLPSGET_STND_INP and then use these utilities to crack the 
command line. The following capabilities are available: 
CLPSCRACK_ COMMAND - 

This routine uses a parameter descriptor table to crack the 
syntax of a command. A parameter vatue table Is bullt specifying 
the actual vaiues from the command. 

CLPSGET_TOKEN — 

This routine returns the next token from a command strings) 
PMPSASCIILTOLBINARY —- 

This routine converts an ASCII string to a binary value. 
PMPSBINARY_TO_LASCIE - 


This routine converts a binary number to its ASCII 
representation. 


For more Information on these routiness see a current source 
listing of them. 


There are two ways to use these routines. One way would be to 
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write a user task program which called on them directty. The 
second way is to modify the NOS/VE command tanguage interface 
{routine CLPSJOB_COMMAND_ PROCESSOR) to process the desired 
commands e This second method might remove the need for a user 
task program to aid in program checkout. 


NOS/VE provides a set of routines which externalize certain 
hardware instructions to a CYBIL programe These routines are 
described fully in a DAP written by Jack Steiner. 


F4.5 PROGRAS HEADER DESCRIPTION 


When a user task is executed via the EXEC commands the text 
string portion of the command is made available to the program. 
Aisos the program can set the status return variable and have it 
displayed by the system at task termination. 


This communication is performed via the parameters of the 
PROGRAM statements which has the following format? 


PROGRAM NAME (P 3 “STRING (255); 
SL t 02240963 
VAR STATUS 3: OSTSSTATUS)3 
The P parameter points to the string specified on the EXEC 
commands and St is the tength of the stringe For internai 


program caliss P can be declared as a “CELL and then any 
structure can be passeds | 


F4e6 COMMON DECK NABING CONVENTIONS 


The general format of a NOS/VE common deck name is? 
XAANNNN 


The xX field denotes the type of deck and is one of the 
foltoning: 


T —- FYPE/CONST deck 
R —- Procedure XREF deck 


The AA field denotes the functional area the deck deals withe 
The field may take on the same vatues as the AA fietd described 
in section 5.1. 
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Then NNNN fietd contains the first four characters of the name 
of the item the deck represents. For XREF*s it is the first four 
characters from the descriptive part of the names ignoring the 
characters P$»s» # and _. For a TYPE/CONST deck the vaiue will be 
TYPE. For a TYPE/CONST deck defining tables the vaitue wit! be 
TBLS. 

Some examples would be- 

Deck name rmcompa from m#compare swap. 


Deck name rciputs from name cl p$put_stnd_out. 


Fae7 IBPORTANT_ COMMON DECKS 


The following NOS/VE common decks are worthy of note? 


TOSTYPE - General OS definitions. 

THDWTYP - Herdware structure definitions. 
TMMTYPE —- Memory management definitions. 

TSMTYPE ~ Segment management definitions. 
TCLTYPE - Command tanguage definitions. 


F4.8 DECK USAGE 


The following rufes apply when using NOS/VE common decks? 


1) TYPE/CONST decks inctude afl necessary keywords and end with a 
semicolon. . 


2) Procedure XREF decks end with a semicoton.e. Other common decks 
may be required to define the types for the parameters 
specified. 


3) Variabte XREF decks do not contain the VAR keyword and end 
with 2a comma rather than a semicoton. Both the VAR keyword 
and ending semicolon must be suppiied in the surrounding 
text. Other common decks may be required to define the type 
symbol. 
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F5-0 KEYPOINTS 


Keypoints are used to give an execution time trace of program 
fiow by showing that a given function is being performed (i.e es 
that a given procedure is being executed). Keypoints are also 
used to display request parameterss status and error conditions. 


F5e1 SOURCE CODE CONVENTIONS 


The general format of the source statement used to generate a 
keypoint from a CYBIL program is? 


#INLINE( *KEYPOINT*»s SECTIONS DATA*2565ID) 3 


The SECTION parameter identifies the functional area that is 
issulng the keypoint. It must be in the range 1 to 15-4 The 
following values are currentiy defined: 


© = Denotes a continuation of data from the previous 
keypoint (the occurance of a trap may not altow this 
feature to work correctly). 
System information (1D numbers 1-63 are reserved for 
use by essembler code routines) (O0SK$) 
Memory Manager {(MMK$) 
Command Language {CLK$) 
Debug (DBK$) 
Cio (ciIK$) 
File Manager (FMKS$) 
Task Services (TSK$) 
Dispatcher (DSK$) 
Unused 
Job Manager (JMK$) 
Signal Handter (SHK$) 
122 Loader (LLK$) 
13-15 = Unused 


Oan ou + wr 4 


bt 
ph © 
oo8 


The DATA parameter can be any 24 bit or tess integer values 
and is normally used to display data that relates to a particular 
keypoint.e The value must be shifted left 8 bits (multiplied by 
256) so that it will not overtap with the ID vaiue. 
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F5.1 SOURCE CODE CONVENTIONS 


The IC perameter is used to identify the keypoint within a 
section. The value must be in the range 0 to 255. Vatues less 
than 31 are considered criticals unexpecteds unusuats etce 


A user may add his own keypoints by using section 15 with 
appropriate DATA and ID values. 


F5e2 KEYPOINT DATA_USING THE HARDWARE 


A circular buffer of the last 200 keypoints ts maintained in 
memor Ye These may be displayed on the console using the 
following command? 


DM <real memory address of the buffer>d 


The buffer is defined by the symbol OSVSKEYPOINT_ BUFFER», which 
will appear in the LINKMAP where the monitor tables are defined. 
The reat memory address ts computed by adding the address of 
OSVSKEYPOINT BUFFER to the length of the page table (monitor 
tabies follow the page tabie). 


Keypoints produced on the hardware are not nearly as useful as 
simulator keypoints because only the last 200 are availabte and 
they are displayed in an unedited format (i.e.s a hex memory 
dump). Howevers they can be useful in showing the sequence of 
events leading up to a system crashe 


The format of the keypoint buffer is an array of nords with 
each word having the folloning format? 


Left 28 bits - Value of free running microsecond clock when the 
keypoint occured. 

Next 4 bits - Keypoint class 

Next 24 bits - Date value. 

Next 8 bits ~- Keypoint id value 


F503 KEYPOINT DATA USING THE SIMULATOR 


When executing on the simulators aff keypoint§ instructions 
cause an entry to be added to the focal fille SESSMKF. When 
execution is completes this file may be processed by a utility 
program to produce a fisting of the keypoint information in a 
readable format. 
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F5e3e1 KEYPOINT REFORMATTING UTILITY. 


The SESSMKF file produced by the simutator can be reformatted 
into a readable tisting by executing the following procedures 


SES eNVEKEY {KPF= ] CFORMAT= J) CAREA= } 


The B parameters if presents causes the procedure to be run as 
a batch job. 


The FN parameter specifies the name of the file contesining 
keypoint datae The default is SESSMKF. If this file is not a 
local Files or the procedure is running in batch modes the fiie 
will be obtained from the current catalog. 


The PR parameters if presents causes the reformatted tiisting 
to be sent to the printer. 


If run interactivelys when the procedure terminates the 
reformatted tisting is on tocal file KEYFILE. 


The RNVEKEY procedure requires two additional files as input. 
The first file defines how the keypoint information is to be 
reformatted. The name of this file is KEYDESC and it is obtained 
from the current catalog ors if not present theres from the 
NOS/VE catalog. The format of this file is described in section 
603026 


The second input file  prevides directives to the utility 
program which direct its execution. The foltowing directives are 
supported: 

CV MAXPROCIO N 


This directive causes aif keypoints with id vatues greater 
than N to be ignored. 


CV UNDEFINED 
This command causes both defined and undefined keypoints to be 
printed. An undefined keypoint is one that does not have a 
definition in the KEYDESC file. 
CV DEFINED 


This command causes onty defined keypoints to be printed. 
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F5e3~e1 KEYPOINT REFORMATTING UTILITY 


CV IDENT 
This command causes the keypoint processor to indent the 
output produced based on the NS field of the KEYDESC file. 
RUN 


This command causes the processor to make one pass over the 
keypoint file. It is used after the CV commands have specified 
how to process the keypoint information. 


END 


This command terminates the keypoint processore It must be 
the fast command. 


These directives are read from file RNOSKEZ. This file is 
obtained from the current catalog ors if not found theres from 
the NOS/VE catalog. 


F5e0302 KEYPOINT DESCRIPTION FILE 


The keypoint description file is used by the keypoint 
reformatting utility to direct the reformatting of the keypoint 
informations Each tine in the file describes one keypoints and 
has the following format: ; 


SID SCN PID LN F LEN FMT CSTR NS DT 


The SID field represents the section ID and ts 2 characters 
fonge An exampt$e would be MM for memory manager. 


The SCN field is the section class numbers which equats the 
SECTION value from the keypoint instruction. 


The PID fietd is the procedure IDs which equais the ID vatue 
from the keypoint instruction. The SCN and PID vatues uniquely 
define a keypoint ~- ali of the other information is used for 
reformatting. 


The LN field is used to cause a line on the keypoint tisting 
to be preceeded by a * if the LN value is zero. This feature is 
used to mark a given keypoint as special. 


The F fieid specifies that this is a special keypoint (Cl.e@e» 
has special meaning to the program that formats the keypoint 
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F50302 KEYPOINT DESCRIPTION FILE 


file). The values must be one of the folloning?: 


Not special 
Task switch 
Begin trap 
End trap 
Begin monitor 
End monitor 


mewn o 
#t!eteoee 


Any new keypoint descriptions should specify this fieid as 
zero unitess the utility program is modified to handie the new 
vatue(s). 


The LEN fleltd specifies the length of the data portion of the 
keypoint in bytes. : 


The FMT field specifies in what format the date portion of the. 
keypoint should be displayeds and can be one of the following: 


H - Hex 
I - Integer 
A- ASCII 


The CSTR fietd is al to 8 character string describing the 
data portion of the keypoint. 


The NS field specifies the number of spaces to indent the DT 
string on the reformatted file. This feature can be used to shown 
procedure nesting via keypoints. 


The OT fietd is a text string that describes the purpose of 
the keypoint. It may fill the rest of the current tine. 


The user may add his own keypoint descriptions to this file 
and save it in his cataloge When RNVEKEY fs runs the existing. 
NOS/VE keypoints and user defined keypoints wilf be tisted 
together. If the NOS/VE keypoints are not wanteds their 
descriptions may be deleted from the file. 


F5e3-e3 REFORMATTED FILE DESCRIPTION 


The reformatted tisting file contains two sections. The first 
is a summary of the number of times each keypoint occurred. The 
second section is a etisting of all the keypoints in the order 
they were issuede Each tine of the second section has the 
following format? 
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RT TSt DATA CSTR $ TN SID DT 


The RT fietd designates the value of the free running 
microsecond clock (time since deadstart) when the keypoint was 
executed. On the simulator the clock is incremented by 1 for 
each instruction executed. 


The TSL fietd designates the time (microseconds) since the 
fast keypoint instruction was executed. 


The DATA fleltd specifies the value of the data portion of the 
keypoint in the format described in the keypoint description file 
for this keypoint. 


The CSTR field is the CSTR fleid from the keypoint description 
file for this keypoint. 


The 3S fieid specifies the state of the machine when the 
keypoint was Issued and is one of the following? 


M —- Monitor mode 
J - Job mode 


An * preceding the S field indicates that trap processing 
is actives ieee.» the trap handier has been entered but 
not exited. 


The TN fieid gives the global task id of the task that was 
exec; , 
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F6.0 DEADSTART PROCEDURES 
F6e1l STAND ALONE DEADSTART. {WITHOUT NOS/170) 
o Set the PPS deadstart panel as fotlows? 
(Note that this is not the setting for the I0U)) 
Losation aettios Insfteuction 
1 7513 DCN 
2 2001 Loc 
3 0000 
4 7713 FNC. 
5 0060 (Warmstart read: 556 bpis 
unit 0) 
6 7413 ACN. 
7 7113 IAM 
10 6200 


o Set SWEEP/LOAD/DUMP switch on the PPS panei to LOAD positions 
o Mount deadstart tape on unit 0. 
o Verify that the 512 printer is READY. 


o. Depress DEADSTART button at keyboard/display consote (the 
message "PROCEED" should appear on the teft screen). 


o Type SS (folfowed by a carriage return) to complete system 
initializatione 


F6e2 DEADSTART WITH _NOS/170 


This deadstart procedure uses the Common Test and 
Initiaetization (CTI) facility of NOS/170 to deadstart NOS/VE. It 
requires two tape units, one for the NOS/170 deadstart tape and 
one for the NOS/VE deadstart tape. 


Detailed information on the use of CTI is located in chapter 2 
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of the NOS Version 1 Gperators Guide (60435600 J) 


0 


Set the deadstart panel as follows? 


Location settiaog 
1 0000 
2 0000 
3 0000 
4 75TT 
5 77TT 
6 EDOD 
7 74TT 
10 71TT 
11 7301 
12 RPXX 
13 RPXX 
14 0000 


TT ts the channet number of the tape unit containing the 
NOS/170 deadstart tape. 


E is the equipment number of the tape controller. 
DDD is broken down as follows: 

FFU 
FF specifies the type of unit being deadstarted from and tis 
12 for 67X tapes», 26 for 66X tapes and 3U for 844/885 
diskse 
U (or UU) ts the unit number of the devicee 


Words 12 and 13 (RPXX) can be ignored as they are only used 
during NOS/170 deadstart. 


Mount the NOS/170 deadstart tape on the unit described by the 
deadstart panel settings. Mount the NOS/VE deadstart tape on 
another unit. Press the deadstart button. The CTI *A* 
display should appear. 


Select the U (utilities) option. The CTI *U* disptay shoutd 
appeafe 


Select the A (elternete deadstart) option. CTI will ask for 
the device types channels equipment and unit of the device to 
be deadstarted from. The vatues supplied by the user should 
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F620 DEADSTART PROCEDURES 
F6.2 DEADSTART WITH NOS/170 


be the ones for the NOS/VE deadstart tape unit. 


o The messege "PROCEED" should appeare Type "SS" to start 
NOS/VE. 
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F7.0 NOS/VE_TEST PROGRAMS 


NOS/VE thas a set of programs which run as user tasks. These 
programs provide the following features: 


- checking specific hardware features. 
~ checking specific NOS/VE software features. 


- creating a heavy and/or uniform toad on the system. 


F7ol EXISTING TEST CASES 


F7.-1.21 SORT 
This program creates an array of records with random keys» 
then sorts this array and checks the results. 


The program atltows a controtied amount of toad to be applied 
to the system paging mechanism. 


syntax? EX SORT "NR»RS? 

NR — The number of records to be created and sorted. 

RS - A factor affecting the size of each record. By varying 
record sizes the user can change the ratio of CP time to I0 
time for a teste The approximate record size is given by 
the formula? 


32+B*RS 
F7e21.2 USERI 


This program will display the line: 
Suser task executing! 
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and then terminate. It is used to show that the system can at 
feast execute a very small test case. 


syntax: EX AAAA "STRING? 
STRING =~ If this parameter is presents it wilt be a after 
the ‘user task executing! messagee 
F7.21.3 YUTL 
This program provides a variety of different test casess and 
also allows them to be run in a repetitive manner. 
syntaxt EX UUTL **STR# 


STR ~- A string describing which program to run and how to run 
it. The various programs are described betow. 


F7ele3e1 ENYSPEC 


This program generates an environment specification errore 
syntax? EX UUTL PENVSPEC? 


F7.123-22 AROVEL 


This program generates an arithmetic overflow error. 
syntax? EX UUTL "*AROVFL® 
F7.12323 INSSPEC 


This program generates an instruction specification error. 
syntax: EX UUTL *INSSPEC® 


F7.21.3.4 DIVELT 


This program generates a divide fault error. 


syntax? EX UUTL "DIVFLT® 
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F7.12305 LA 


This program performs an tA (toad address) instruction on a 
specified PVA. It can be used to test various forms of memory 
protection. 


syntax! EX UUTL "LA sPVA® 
PVA - The virtual address to be loaded from. 
F7el-326 SA 


This program performs an SA (store address) instruction on a 
specified PVA. It can be used to test various forms of memory 
protectione 


syntax EX UUTL *SAsPVA? 
PVA - The virtual address to be stored into. 
F7ele3e7 RETURN 


This program modifies the previous stack frame area and then 
returns to see what effect the modifiction will have. 


syntax? EX UUTL "RETURN »N*® 
N - Modification option. Must be one of the following: 


Set vaiue of A2 so it is not O mod 8. 
Set A2 bit 32 to l. 
Set A2 segment number invalid. 
Set A3 segment number to segment without read access. 
Set P register segment number invalid. 
Set P register so it is not 0 mod 2.3 
Set P register bit 32 to l. 
- Set P register segment number to non executable 
segment. 
9 =- Set final AO < > A2e 
10 - Cause VMID error. | 
11 - Cause inwerd return. 
12 - Cause return to C170 modee 


aot oO wm & Ww Wh pe 
(eeteteoe#s 
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F72le3e8 JESIMEM 


This program createss writes and verifies an array of 
records. The record size is such that some records wittl be 
located on a word boundarys some on all seven (other) byte 
boundariess some will cross pagess etc. 
syntax: EX UUTL "TESTMEMs, BC? 


BC - Number of bytes to be alflocated to the records. The number 
of records created is: BC DIV 1741. 


F7.123-9 JESTMOVE 

This program is similar to TESTMEM, except that  BDP 
instructions are used to compare and move records. 
syntax: EX UUTL tTESTMOVE,8C® 


BC = Number of bytes to be allocated to the records. The number 
of records created is? 8C DIV 255%#2 4+ 1. 


F701.3.10 RECURSE 


This program calls a procedure recursively. 
syntaxt EX UUTL PRECURSEsN!® 
N ~- The number of times to recursively call the procedure. 
F7e1l.e3-11 CYCLE 

This program cycles for a specified number of milliseconds. 
It can be used to toad the system with tidite tasks. 
Syntaxt EX UUTL *CYCLEsMS* 
MS - The number of milliseconds to cycle fore 
F701.3012 ITIMEQUI 

This program delays for 2 specified amount of time in 
incrementse 
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F7ole3.12 TIMEOUT 


syntax? EX UUTL "tTIMEQUTsTisT2? . 
Tl = The number of miliiseconds in each pmptdetay request. 
T2 ~ The total number of milliseconds delayed. 
F7.1.3.-13 LOOP 

This program loops (executes) for a specified amount of time. 
It can be used to foad the system with active tasks. 
syntax? EX UUTL "LOOP,MS* 
MS ~ The number of milliseconds to execute for. 
F721.23214 AZO 

This program creates a segment with reads writes execute and 
binding attributess places C170 code into it and executes that 
code. The code executed counts down an X register and when it 
gets to zeros executes an fitfegai C170 jinstruction (op code 
0178). 
syntaxs EX UUTL *AlLT7OsN# 


N = This vatue times 1000000 is placed in the X register being 
decremented to zero. . 


F7.2123-15 REPEAT 


This program synchronously executes a program a given number 
of times. 
syntax? EX UUTL "REPEAT sPNoNs* STREP 


PN —- Name of the program to execute. It can be aft'y”9 program 
present in the NOS/VE ftibrary. 


N ~- The number of times to execute program PN. 
STR =- The parameter string passed to the program when it begins 


execution. Note the use of doubfe quote marks within $a 
quoted string. 
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F7.123216 CALLER 


This program is similar to REPEAT» but the tasks are run 
asynchronousty. | 


syntax? EX UUTL CALLER» PNoNs*STR** 
The parameter definitions are the same as REPEAT. 


F7 ele3el7? BULK 


This program runs a number of different programs a specified 
number of times. This test is used primarily to load the system 
with ai orandom mix of programs. Some programs will terminate 
abnormaliy. 


syntax: EX UUTL "BULK a Ns X? 


N- The number of times. to. execute the entire tist. The 
following programs (with parameters) are executed 


LOOP s5 

TIMEOUT, 5 

CYCLEs5 

INSSPEC 

ADRSPEC 

ENVSPEC 

PRIVINS 

LAs 257800000000(16) 
S$A»s100200000000(16) 
AROVFL 


X - If this parameter is specified (any vatue except 1) then the 
test wilf be run asynchronously - that iss each test in the 
list will be started and after they are all runnings the BULK 
test willl wait for them all to complete. This procedure is 
repeated N times. 


If this parameter is not specifieds or is specified as ls each 


test will be attowed to complete before the next test in the 
fist is started. 
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F701.23018 BULKNIC 
This program is similar to BULKs except that all of the 
programs run are expected to complete normally. 
syntax? EX UUTL *BULKNTCsNoX® 
N - Same as for BULKs except the program tist is the fottowing: 
LOOP,500 
LOOP,5 
TIMEDUTs 5,500 
CYCLE, 500 
RECURSEs 5600 
LO0P,10 
TES TMEMs100000 
TES TMOVEs 100000 
LOOP ,1000 
X ~ Same as for BULK. 


F721.2.3219 ADRSPEC 


This program causes an address specification error. 
syntax: €X UUTL *ADRSPEC? 
F70le3-e20 PRIVINS 


This program causes a privileged instruction error. 


syntaxt EX UUTL *PRIVINS® 


F722 EXAMPLES 


To run the sort program on 1000 records of size 200 dos 
—X SORT #41000, 200* 
To run 53 asynchronous copies of same sort test do! 
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F722 EXAMPLES 


EX UUTL P#CALLERsSORTs53941000s200!* 
To run the same sort test 45 times in successions do 
EX UUTL TREPEATsSORT9459*1000s 200** 


HINT? When running programs which may run for a tong period of 
times use the *A® option on the EX command. This runs the 
programs asychronousty with the command processore This 
allows you to status the test to see nhat is happening 
(TSTATUSs PFSTATS) or to terminate the test if it runs too 
jong (TMTERM). 
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61.0 CYBIL_VERSION_.12.0_ LEVEL 81188 


Too! ID CY 

Tool Files 

Source PL#s 

PFESRC — Compiter Front End 
PCGSRC7T - CC code generator 
PCGSRC8 - CI code generator 
PAXCMN —- Global common decks 
PLBSRC7 - CC run time library 
LBSRC80 - CI run tise tibrary 
Binary Files | 


PFELIB —- Compiter Front End 


PCGLIB7 - CC code generator 
PCGLIBS8 —- CI code generator 
CyscoBJs - CC run time binaries 
CYBICBJ —- CI run tiwe binaries 
CYBCLIB - CC run time ftibrary 
CYBILIB —- CI run time tibrary 


CYBHBIN - II front ends code generator and run time binaries 
Absotute Fites 


CYBILC — CYBIL=-CC compiter 
CYBILI —- CYBIL=-CI compiter 
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62-0 BUILD _INTERDEPENDENCIES 


The following tools and files must be available for the build 
process to execute. 


MADIFY - ASCII version of Modify 

SESULIB - I/G and miscettaneous routines supplied by the SES 
project. Found on SES numbered file SES xxxx. 

PROCLIB - File containing SES procedure COMPII for building the 
II front end and code generator. Found in LP3. 

SIMCOBJ - Simutated NOS/VE interfaces supplied by the SES 
project. Found on SES numbered file SESxxxx. 

SIMIOBJ =- Simuteated NOS/VE interfaces supplied by the SES 
project. Found on SES numbered file SES xxxx. 

Cis0 ASSEMBLER - €180 Assembier and SYSTEXT supporting the new 
object text 

C180 OCU — Generate Object Library command 

CYBIL-CC - An existing CYBIL-CC compiter 

CYBIL-CI —- An existing CYBIL-CI compiler | 

CYBCCMN ~- SES common decks for CYBIL-I0 and SES utilities. Found 
on SES numbered file SESxxxx.e 

CYBCIMN - SES common decks for Simulated-I0 and SES utilities. 
Found on SES numbered file SESxxxx.e 

CCCOMPL = Interfaces to the Common Compiler Modules. 

CCMLIB — Binaries of the Common Compitfer Modutes. 
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63.0 CYBIL COMPILER BUILDS 


This paper describes the procedures reaquired to build the 
CYBIL CCs CI and {I compiters. Ali of the builds are adaptabie 
to run in any user catalog. The builds for the CC and CI 
compilers and all of the libraries are written predominantly in 
CCL with associated usage of SES procedures. The build for the 
II compiter is an SES procedure. 

The general approach to building the compilers is first to 
generate an object tibrary for each togical entity of the 
compifers and then for the CC and CI compiters to combine these 
objects into an absolutized compifer. For the II compiters the 
object tibraries are combined with the run time library 
binarles. When the compilers are buitt for a non-CYBIL project 
Catalogs the run-time checking and debug code shoutd be turned 
off. 


63.1 PROCEIL 


Get file PROCFIL from LP3 and save in the catatog where the 
bullds wil! be processed. 


G3.2 BUILD PROCEOQURES 


To compite the source Plss the following command is used? 
SES eDOs(* CCL Ubegin_command') sdefer. 

The format of the CCL begin _command is: 
BEGINsproc_namesPROCFILssrcssrcunstibschksdebug. 
or BEGINsproc_namesPROCFILssrcssrcunsobjschksdebug. 

For building the CI/II tibrary the CCL begin_command ist 


BEGINs BCYBIOBs PROCFILyssrcyssrcunsobjschks debugsSIM/HDWRe 
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G3.2 BUILD PROCEDURES 


proc name - Name of the bulld procedures default is appropriate 
file name as titisted in section 1.0. 


src - Name of madify PL containing the sources default is 
appropriate file name tisted above. 


srcun ~ User name for srcs defauit is LP3. 


libfobj - Name of file to receive new object library or object 
files default as for src. If the file already exists 
it will be overwrittens otherwise it will be 
DEFINEde For BCYBIONB with the HDWR option the file 
name must be specified if defauit was used with the 
SIM option. 


chk - Run-time checking mode for compiler being bullts 
default is no checking (CHK#0)» CHK key afone impties 
all checking options (CHK#NRS)» otherwise specify 
desired CHK parameters. 


debug - Debugging option for complier being builts default is 
: no debugs keyword atone implies compile internal 
compiter debug code. : 


SIM7HDWR - Parameter for BCYBIOBs SIM specifies that tibrary 
will be used with the CI compiters HDWR specifies 
that library will be used with the II compiler. 


Allowable CCL build commands are? 


BEGINsBPFELIB. {Compile front end} 
BEGINsBCYBIODB. {Compite ci tibrary} 
BEGINsBCYBCOB. {Compite ce tibrary} 
BEGINsBPCGLB7. {Compite cc code generator} 
BEGINsBPCGLBS. {Compite ci code generator} 


To buitd a compiler with checking mode turned on add the CHK 
parameter. To enabfe the compiler debug code add the DEBUG 
parameter. 


63.3 PROCLIB 


The SES Proctib must now be moved from the tUP3 catalog to 
access the procedures that complete the compiler buiids. 
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630% BUILD PROCEDURE FOR II COMPILER 


To compite the source PL*#@s»s the following command is used 
SES.COMPII (mods)s0bjstype=stypunsHsDEFER. 
mods - module names to be compllieds for the front ends mods 
would be ABSNEG.~ eWRITEPRsBIGQIO. -PXQOPEN,CYBILIT. 
For the code generator mods would be IBABSR1.eUNSATRF 
obj - Name of file to receive new object file. There is no 
default. If the file atready exists it will be 
overwrittens otherwise it will be DEFINEd.. 
type - specify FE for front end or CG for code generator 


typun —- user name for compiler to be used.e Default is LP3. 


63-5 BUILD COMPLETION 


G3e5e1 TO BUILD CYBILICC 
SES.GENCIt CC. 
63.5.2 TO BUILD CYBIL/CI 
SES.GENCIL Ci. 
63.5.3 TO BUILD THE II COMPILER 
SESsSSSeGOF BASE = (FEobjs CGobjs LIBobj) UPON = CYBHBIN 
feobj - name of the file containing the II complter front end 
binaries . 
cgobj - name of the file containing the II compiler code 


generator binaries 
libobj - name of the file containing the II run time binaries. 
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63.0 CYBIL COMPILER BUILDS 
63.5.4 TO BUILD CC RUN TIME LIBRARY 


63.504 TO BUILD CC RUN TIME LIBRARY 


ACQUIRE (CYBCOBJ) 
AC QUIRE(SESULIB= SES xxxx/un=SES 
ACQUIRECSIMCOBJS*#SESnnann/un=S€$ 
SESsREPULIBICYBC OBJ,» SESULIBsSIMCOBJ) NL=CYBSCLIB NX#1 
Note3 See SES retease manager for actual permanent file 
names SESxxxx and SESnannn shown above. 


6325.5 TO BUILD THE CI LIBRARY 


ACQUIRE(CYBIOBJ) 

AC QUIRECSIMIOBJ=SESnnann/un=SES) 

RETURN(Libtemp) 

SES.GOL f=e(CYB8IOJBsSIMIGBJ) UP=tibtemp 

SESsREWRITE tibtemp CYBILIB 
Note: See SES releae manager for actual permanent file names 
SESnnnan shown above. 


This tibrary now includes the simufated NOS/VE interfaces. 


63-6 JEST COMPILERS 


G3.6.1 CC REGRESSION TESTING 


The basic testing for the CC compiter is the convergence of 
the compiter. 
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63.0 CYBIL COMPILER BUILDS 
G3e6.2 CI REGRESSION TESTING 


63.602 CI REGRESSION TESTING 


The test cases exist on file CIBASE/JUN=HAW. Common deck 
PROLOG contains the attach for the compiler to be tested. Common 
deck COMPILE contains the compiler cali statement and associated 
options. These common decks shoutd be checked to ensure they are 
setup for the intended run. 

To submit all the tests do? 

SES eRUNCT »m=(CY001.-CY999) sCLEAR 
After completion of the execution of the test cases do 
SESsRUNANL 


to analyze the results of the regression run. 
G3e623 II TESTING 


The current tests to be run are Testls Test2s Test3s Test4s 
Testl from Testpif/uneTJR»s TestM and TestN from testpi/unsROD. To 
get the tests from testpls use the SES procedure gencomp. 
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63.0 CYBIL COMPILER BUILDS 
A170 NOS DEADSTART 


H1.1 


H1el .A1LZO_NOS_DEADSIARI 
Bult Ni5 


Date: 


in 


6 


0 


0 


eooeoo 3s 


0 


4/30781 
The system is eueticuced to run with three FMD units (41»s 
42 and 43). 
Mount the pack fabeled “Advanced Systems Integration E€E!1 
Pack™ on any 844 disk drive EXCEPT UNIT 0. 
Set the D/S panel to deadstart from the primary system 
disk. This is Unit 43 for all Build N systems... 
Push D/S button 
Do an alternate deadstart to tape DUAL6N? 
Select "U" display 
Select "S" display 
Deadstart Device Type - 2 (CR) 
Channel —- 13 (CR) 
Equipment - 0 (CR) 
Unit - xx (CR) (where "xx" is the tape unit. number) 
Setect "0" display 
Select "H" display 
Enter CM=10000 
Enter CACHE0-3=0FF 
Enter (CR) 
System will display the message “ENTER LOCATION OF MSL/HIVS 
DEVICE". Enter: 
- Channel —- 03 (CR) 
- Equipment - 0 (CR) 
- Unit = xx (CR) (where ®xx" is the unit number of the 
844 drive where the EI pack is mounted) 
Enter date/time 


toeede 


Wait for deadstart to complete. 
Note: The deadstart tape DUAL6N and the EI pack are both found 


the area in the northeast corner of the room where the tape 


cabinet and bookcase of disk packs are found. 


H1.2 CURRENT DUAL. STATE CONEIGURATION 


i) 


0 


FMD Unit 43 
This unit contains the following: 
- A170 NOS (Build 6 levet)ds CTIs MSL» EI binariess NOS 
deadstart files 
- Files associated with user number LIBRARY 
- Files associated with user number SES 
- Files associated with DEV1ls REL1s INT1. 
FMD Unit 41 
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63.0 CYBIL COMPILER BUILDS 
H1.2 CURRENT DUAL STATE CONFIGURATION 


This is a scratch unit 
o FMD Unit 42 
This unit contains the foltowing: 
- NOS/VE Development Ara PL*s and Member PL*s 
~ NOS/VE Deadstart Files to be tested (saved in 
individual user*s catalogs) 
~ Files associated with user number INT2 


H1.3 NOS/VE_DEADSTART 


o The following flie must be avaitabte in your catalog on the 
$23 ; 


TPXKXXK contains a NOS/VE deadstart image. This must be a copy 
of the dual state deadstart images available from the tink 
procedurese CIMAGEs PPIMAGEs RGIMAGE are "fast" filess which are 
built from TPXXXK the first time you deadstart NOS/VE. These 
files are then used on subsequent deadstart attempts. Before a 
new TPXXXK can be useds these “"fast™ files must be purged off 
your user number. 

o Mount the disk tabeled *"DAHL=-Large sector" on 844 unit 0 
(other disks will not work). The default disk driver for 
build M is the NOS/VE driver. 

o Bring up dual state? X.UPMYVE (CAT=mycats DEVi=scat) where 
mycat = user catalog fas before) 

scat = system catalog —- INT2 or INT1 (defautts to DEVI) 

o The UPMYVE job will display the following? REQUEST ¥*K#*. 
DISPLAY on the B display Type Ksne where nis the control 
point number of the UPMYVE Jjobe. 


H1.4 BRING _UP_C170_ REMOTE HOST 


Type 

TAFNVE. 

Controt point two must be free or rolloutable (teees NAM 
should not be there)e This also brings up nena and the 
MLI subsystem control points. 
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63.0 CYBIL COMPILER BUILDS 
H1.5 BRING UP C180 


H1-5 .BRING. UP_C180 


The following sections use the files of LO or L1 to enter the 
needed commands to bring up all the needed 180 tasks to run 
NOS/VE at this tevet. 


If you change any of the following decks you MUST use the LO 
deadstart from your own catalog (with files CYBILOG, XLJGSL»s and 
XLJLIB}? 


AMMTSA BAMDVR BAMPC4 BAMPC2 BAMPC1 BAMPC3 IIMRSE IIMRLE ITIMRUM 
IFMEXEC YFIMA72H TIMTDEL ITIMRUSM IIMDC2S OCMREO OCMMUR OCMBIM 
OCMSDL OCMEND OCMLP OCMCPY GCMCRM OCMGEN OCMOMS OCMDEF OCMREP 
OCMOLG OCMCOL OCNOBS OCMCHA OCMNOFH OCMADD OCMNP OCMDEL OGCMOLB 
OCMCOM OCMSAT RHMQAF RHLFN RHMQIP RHSEND RHMLOF RHAMLI RHMQOP 
RHMQTE RHMALCF RHTEME RHLOG RHMGRJ RHMQRE RH88812 RH81288 RHROUTF 
RHWRTLF RHRTRNF RHFETCH RHGETDM USORT UUSERI UUTL 


H1.5.1 BRING THE SYSTEM UP FOR THE FIRST TIME FROM YOUR CATALOG 


Type 

Kane where n is the UPMYVE controt point numbere- 

KeLIU (yourunsNVE) your password. 

Ke GETsLOslLOssDEVIsNVEsA6~ 

Ke INCLUDE LO. 

The systea is up when the following message comes up? 
SYSTEM IS NOW ALL UP AND RUNNING 
WAITING FOR MORE INPUT 


H1e5e2 BRING UP THE INTEGRATION SYSTEM (GR YOUR*®S AFTER 1ST TIME) 


The Integration system has had the LO file ran on tte Also 
the file produced by the LO deadstart have beed asde semi-public 
and et found on the cataiog used in the UPMYVE calf. 


Type (where DEVIL is the same eas the CATevatue in the UPNYVE 
cali): 
Keane where n is the UPMYVE control point number. 
KeLIU (DEVISNVE) DEVIXe 
Ke GETslilsllassNVEsA6~ 
Ke INCLUDE Ll. . 
The system is up when the following message comes up? 
SYSTEM IS NOW ALL UP AND RUNNING 
WAITING FOR MORE INPUT 
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G3.0 CYBIL COMPILER BUILDS: 
H1.6 NOS/VE TERMINATION 


H1.6 .NOS/VE_ TERMINATION 


Bringing down dual states 


Ke #BYEVE. 
Ke *ENDRUN 


Hie? _DSOL INEORBATION 


Hle7e 1 


ooo 0060 


TO CREATE AN EXPRESS DEADSTART DUMP CEDD) TAPE: 


Mount scratch tape (ring in) on a 9=track drive. 
Push D/S button. 
Select U Cutilities) display. 
Select E (EDD) display. 
Set channel ($2213). 
Set ECUU (S$2=0Oluu) 

E = Equipment 

€ = 1 for 67X drives 

2 for 66X drives 

uu = untt number of the tape drive to be usede 
Answer "non zero inhibits renind™ with a CR. 
Answer “dump number" with a CR. 


Answer “dump controltware™ with a CR. 


H1se7s2 TO CREATE A LISTING OF THE EDD TAPE? 


0 


0 


REQUEST sDUMP »sNTsD=PEsF2S sLB2KUsPO2RsVSNzyour choice. 

GETsDSDIZUN=DEV1. (Qn SIN 101-2) 
or 

GETsDSDI/UN*DEVI1. (Gn $2.) 

Create DSDI directives files: 
A OSOI directive file shoutd inciude the Foltowing: 
IGUMR. 
PROMR. 
MEMMR. 
PRORF. 
Wefirst _byte_addressstast_byte_addresssasid. (where the 
first -byte_address and tast lbyte_address are hex byte 
addresses and asid is the asid of the segment to be 
dumped) 
or 
Wefirst _byte_address_last_byte_addressssegment_ 
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63.0 CYBIL COMPILER BUILDS : 
H1e722 TO CREATE A LISTING OF THE EDD TAPE: 


number sexchange_packagee Exchange package is the RMA of 
an exchange package or the keywords MPS or JPS. 
o Execute DOSDI:! 
RFL»60000.. . 
DSDI asMeDsIl="input directives File. 
o To run Cafter the first time): 
DSDIsTIen. 
(Does not read tape sonnet 
o To run interactivetys 
Same as aboves except to do W eeaeand must first do 
OUTPUTsLISTFIL. 


o C170 DSDOI information can be found in Chapter 10 of the NOS: 


SYSTEM MANTENANCE Manuafe A170 DSDI info can be found in 
document ARH3060 - GID for A170 NOS7#7S2. 


H1.8 _TO_ RELOAD CONIROLWARE FOR THE DAHL-LANGE SECTOR 845 


The following commands need to be entered from deadstart 
o Push D/S button 
o0 Setect “U" display 
o Select "S*® display 
o Sefect TYPE#3 
o Select C21 
o Select CH=1 
o Setect EQ=0 
o Setect UN#43 
o Setect "M*" display 
o Carriage return 
o Type in "CW MAB 22" carriage return wait until LOADED 
o Then redeadstart using section 1 


H1.9 ADDITION NOTES ON BUILD 


o For the use of COL (CREATE_OBJECT_ LIBRARY) the following 
180 commands are needed? 


GETsSYSLIBsSYSLIBss DEVI sNVE»856 
GETsC YBILIBsCYBIILBssDEVI»sNVEsB56 
SETOL ADD2SYSLIB 


o The above commands will be needed for all utilities other 


then CITOII. 
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